Re: Guile web page docs

[Andy Wingo <wingo@pobox.com>]

On Thu 29 Oct 2009 00:20, ludo@gnu.org (Ludovic Courtès) writes:

> Neil Jerram <neil@ossau.uklinux.net> writes:
>
>>>>>> (BTW, Gnulib has a new script to automate updates to
>>>>>> www.gnu.org/software/PROJECT/manual.)
>>>>>
>>>>> Right; I assume you mean gendocs.sh.
>>>>
>>>> I was thinking about the ‘gnu-web-doc-update’ module.
>>>
>>> I'll take a look, thanks.
>>
>> [guile-user trimmed]
>>
>> This doesn't look so useful to me.  It makes assumptions about the
>> package that don't hold for Guile: a bootstrap script (our autogen.sh);
>> manual in doc/manual; and a `make web-manual' Makefile target.
>
> Hmm, OK.  I’ve never actually used it and I didn’t know that.
>
>> We could make Guile conform to those assumptions, but I'm not sure it's
>> worth it.
>
> Agreed.
>
>> Isn't it already pretty easy to use gendocs.sh, copy the generated
>> files into the web-pages tree, and commit?  (I've actually never used
>> gendocs.sh.)
>
> That’s what I’ve been doing so far.  It’s slightly tedious because run
> gendocs.sh with the right parameters, have a cvs checkout, copy files
> there, add the new ones (and ideally remove the obsolete ones), then
> check-in and wait for ages.

It's possible to automate this. The crux of it is "cvs import" :)

dir=~/src/guile-gnome/platform/gtk/doc/gtk
file=guile-gnome-gtk

all:
	@echo "try make update"

index.html: %.html: %.scm
	( guile --debug -l $< -c '(make-index)' > $@ || { rm $@; false; } )

update: index.html
	rm -rf html
	( export tmp=`mktemp -d`; \
	  export cur=`pwd`; \
	  cd $$tmp; \
	  mkdir $(file); \
	  cp -a $(dir)/*.texi $(file)/; \
	  tar czvf $(file).texi.tar.gz $(file); \
	  cp $(file).texi.tar.gz $$cur/; \
	  cd $(file); \
	  makeinfo $(file).texi; \
	  tar czvf $(file).info.tar.gz $(file).info*; \
	  cp $(file).info.tar.gz $$cur/; \
	  makeinfo -o $$cur/html --html $(file).texi; \
	  texi2dvi -o $(file).dvi -q $(file).texi; \
	  dvips $(file) -o; \
	  gzip -9 $(file).ps; \
	  cp $(file).ps.gz $$cur/; \
	  gzip -9 $(file).dvi; \
	  cp $(file).dvi.gz $$cur/; \
	  texi2pdf --pdf -o $$cur/$(file).pdf -q $(file).texi; \
	  cd $$cur; \
	  rm -rf $$tmp; \
	)
	( export CVSDIR=$(shell cat ../CVS/Root); cvs -d $$CVSDIR import -m 'update manual' guile-gnome/docs/$(shell basename `pwd`) gnu $(shell date "+D%Y%m%d%H%M%S"))

-- 
http://wingolog.org/