On Fri, 2010-03-05 at 15:53 +0800, Paul Wise wrote: > On Fri, Mar 5, 2010 at 3:41 PM, Daniel Leidert > <daniel.leidert.s...@gmx.net> wrote: > > > What's the problem, to write a short manual page, that points to the > > --help switch? All the maintainer would have to do is to provide the > > intention of the command, point to the help/usage switch, relevant > > commands and to locally installed documentation. Such a manual page > > won't unlikely become outdated and it doesn't need much maintenance. > > This goes for both: authors and maintainers. But it still provides the > > necessary information to the user.
> An outdated/unmaintained manual page or one that just points at --help > or existing documentation isn't useful or acceptable. I get to wonder how many DD/DM even ping their upstream about this issue. A short manpage, pointing to "native" documentation have proven to be useful (see GNU programs, and info pages). Wouldn't it be possible to build a manpage the docbook file (because the command lines are documented there, right ?) At the risk of repeating myself, "man $foo" is a unified "Interface" for humans. Franklin -- To UNSUBSCRIBE, email to debian-devel-requ...@lists.debian.org with a subject of "unsubscribe". Trouble? Contact listmas...@lists.debian.org Archive: http://lists.debian.org/1267777763.10430.160.ca...@solid.paris.klabs.be
