Re: Removing the manpage requirement for GUI programs?
- To: firstname.lastname@example.org
- Subject: Re: Removing the manpage requirement for GUI programs?
- From: Yves-Alexis Perez <email@example.com>
- Date: Wed, 03 Mar 2010 19:17:14 +0100
- Message-id: <[🔎] 4B8EA7AA.firstname.lastname@example.org>
- In-reply-to: <email@example.com>
- References: <1267297597.2673.81.camel@tomoyo> <20100227194904.GA25756@crustytoothpaste.ath.cx> <1267300984.2673.106.camel@tomoyo> <20100227233049.GL28743@volo.donarmstrong.com> <1267313988.2673.345.camel@tomoyo> <firstname.lastname@example.org>
On 28/02/2010 01:32, Ben Finney wrote:
> Josselin Mouette <email@example.com> writes:
>> > Yes, I overall agree with your arguments. However having it in the
>> > policy means we get bug reports about manual pages and have to deal
>> > with them, while they are not the primary source of documentation for
>> > command-line options.
> If manpages were useful only for documenting command-line options, this
> would be a valid point. As has been pointed out, though, manpages for
> programs are useful for much more than that.
But that's why he doesn't propose to forbid manpages for GUI programs,
just to not have them mandatory (well, agreed, it's a “should”). For
programs where there's no point in having a manpage (and only them) he
proposes to drop the “should” requirement, that's all.
That doesn't prevent motivated people/upstream to provide manpages, it
just spares some time for maintainers. I have few cases in Xfce of such
programs (like all the xfce4-*-settings).