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