On Thu 29 Oct 2009 00:20, l...@gnu.org (Ludovic Courtès) writes:
> Neil Jerram <n...@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/
