[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

Re: Removing the manpage requirement for GUI programs?

2010/2/28 Josselin Mouette <joss@debian.org>:

> currently policy §12.1 mandates that “each program, utility, and
> function should have an associated manual page”. However, the more I
> stomp on bug reports about manual pages, the less I am convinced of
> their usefulness for GUI programs.

How about replacing "an associated manual page" with "associated
documentation"? Also add a sentence or two saying that said
documentation may be in any format(s) (manual pages suggested)
viewable in Debian and should be well maintained.

help2man-generated manual pages are no substitute for good,
well-maintained manual pages or other documentation.



Reply to: