tags 595151 wontfix thanks On Wed, Sep 01, 2010 at 01:29:12PM +0100, Reuben Thomas wrote: > undocumented(7) could be improved by having the output help2man prog, > if any, inserted into it, as in many cases this will be enough. If the > output were inserted just under a preamble reading "there's no proper > documentation (feel free to submit a bug) but here's what program > --help says", with the current contents of undocumented(7) as a > postamble, then users in a hurry would be better served, and > developers and those in less of a hurry would get the heads up that > there's still a bug here to report/fix.
While this is a nice idea, there are too many programs (particularly quickly-written ones with no argument handling - exactly the kinds of programs that often don't have manual pages) that don't accept --help and just ignore the option and carry on. People expect man to be an absolutely safe thing to run, and this could well end up performing destructive actions; you might argue that such programs are buggy, of course, but it would be too late for the users affected. I'll leave the bug open with the wontfix tag by way of documentation, but I don't plan to implement this. Sorry, -- Colin Watson [cjwat...@debian.org] -- To UNSUBSCRIBE, email to debian-bugs-dist-requ...@lists.debian.org with a subject of "unsubscribe". Trouble? Contact listmas...@lists.debian.org
