Mr Allwyn Fernandes wrote:
>>I've just search through cvs and can't find any sgml or xml stuff. Does
>>anyone have experience with this stuff? It'd be nice to maintain one set
>>of docbook docs, and have the web manual, and the manpages (and the pdf
>>for that matter) all generated from it.
> This discussion occured (briefly) on this list some time back, and as Brad
> pointed out, the result was a switch to Doxygen. As a minimal attempt, I
> changed GENERATE_MAN and MAN_LINKS to YES in manual/gazebo.dox. This created
> a full set of manpage equivalents of the html documentation into
> manual/man/man3/, with the manpages for the binaries being
> manual/man/man3/gazebo_server.3, manual/man/man3/gazebo_wx.3 and
> These don't quite resemble classic man pages, but are rather more like the
> perl man pages. There are no option summaries at the top of the page, etc. I
> assume this should not be a problem from debian's perspective - after all,
> perl gets away with it.
This doesn't generate a manage for the player binary, though. It's the
binaries that debian insists have man pages. I can see it generates
player_util_*.3 which have the utilities' man pages. I can use the old
player.1 from the player-manual for the moment, but it'd be great if
this could be derived from doxygen comments in the source in some way.
However, some of them will be useful for the dev package, thanks.
Those who can, do. Those who can't, simulate.
Cameron Stone <camerons@...>