Automatic generation of html doc of services specification

Guillaume Chereau charlie at openmoko.org
Mon May 26 04:04:53 CEST 2008


On Sun, 2008-05-25 at 19:28 +0200, Stefan Schmidt wrote:
> Hello.
> 
> On Sun, 2008-05-25 at 18:24, Michael 'Mickey' Lauer wrote:
> > Welcome on board, Guillaume!
> 
> Yeah, same from me.
Thanks :)
> 
> > > > generate-html-doc gen_doc_dir doc_dir
> > 
> > That looks good. We could actually even think about adding something like this 
> > into the post-commit hook, so that we can just forget about it and have the 
> > docs autoregenerated on every commit.
Yes, it works on my computer, by adding these lines into the
file .git/hook/pos-commit :

pushd /home/charlie/Test/AutoGenerateDoc	# The script directory
./generate-html-doc.sh . out			# Put the xhtml files in /home/charlie/Test/AutoGenerateDoc/out
popd

and making .git/hook/pos-commit executable. 

> 
> I would second this. Generating it should be cheap enough for the low
> commit rate we have.
> 
> The only problem I see is when people work a lot offline and push a
> bunch of changes. That would trigger the rebuild with every commit
> even if we use only the last one. Do we care about this or ignore it
> as it is cheap enough?
Good question. Also : what happen if 2 persons commit at almost the same
time ? Will the hook run the script twice in parallel ? Maybe the script
should implement a kind of lock to avoid problem.

Regards,
Gui
> 
> regards
> Stefan Schmidt
> _______________________________________________
> smartphones-standards mailing list
> smartphones-standards at linuxtogo.org
> http://lists.linuxtogo.org/cgi-bin/mailman/listinfo/smartphones-standards
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 189 bytes
Desc: This is a digitally signed message part
URL: <http://lists.linuxtogo.org/pipermail/smartphones-standards/attachments/20080526/0e52a8cc/attachment.pgp>


More information about the smartphones-standards mailing list