[RFE] man pages to go along with fine command line utilities

[pbaker@…]

I'm working on packaging MapServer for Debian. Debian Policy requires that all
packaged binaries installed in /usr/bin (where I'm installing the command line
utilities in my mapserver-utils package) must have an accompanying manpage of
some kind. Is anyone in upstream willing to write these for me, or will I have
to make something up on my own?

See http://www.debian.org/doc/debian-policy/ch-docs.html#s13.1

[dmorissette]

Paul, perhaps you should raise this issue on the mapserver-docs list (not sure 
how much response you would get though).

Let's keep this as a wishlist item for 4.1.

[tomkralidis]

We would have to create man pages, as well as a make target to install these and the command line tools, etc. into /usr/local or --prefix sort of thing. Is this still desirable?

[sdlime]

Looks like GDAL uses Doxygen for its command-line programs. Perhaps we could emulate that approach?

Steve

[tomkralidis]

cc'ing Frank, as his doxygen adventures in gdal may be of help

[jmckenna]

Can this be automated at all? Or are you all looking for someone like me to make these man pages? Need feedback.

[tomkralidis]

I spoke to Frank about this over irc awhile a couple of months ago, and seem to remember us discussing just creating the man pages manually, and have them included in a build target somehow.

Having said this, we would need to:

• figure out what utils we want to document for man
• come up with a way of syncing these with any other places (website?) they are documented.

Comments?

[jmckenna]

7 year old ticket..closing