Automatic generation of html doc of services specification
Michael 'Mickey' Lauer
mickey at vanille-media.de
Sun May 25 18:24:02 CEST 2008
Welcome on board, Guillaume!
> > 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.
Speaking about docs, are you familiar with docbook? I think our docbook xsls
could need some love, e.g. where we specify a{sv} as return value, until now
we literally gave the values that the clients could expect, it would be much
nicer, if we would have specific docbook constructs for that, e.g.
<doc:expectedvalues>
<doc:value name="foo">explanation for foo</doc:value>
<doc:value name="foo">explanation for foo</doc:value>
<doc/expectedvalues/>
:M:
--
Dr. Michael 'Mickey' Lauer | IT-Freelancer | http://www.vanille-media.de
More information about the smartphones-standards
mailing list