Re: Guile web page docs

[Andy Wingo]

On Thu 29 Oct 2009 00:20, address@hidden (Ludovic Courtès) writes:

> Neil Jerram <address@hidden> 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/