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

Re: manpage for GNU utilities?



>>>>> "Manoj" == Manoj Srivastava <srivasta@datasync.com> writes:

Manoj> I would hate to be the maintainer of the packages fileutils,
Manoj> shellutils, and textutils (Galen Hazelwood <galenh@micron.net>),
Manoj> who has a whopping 61 man pages to write.

I agree with Manoj.

Isn't writing and *maintaining* fullblown manpages for a larger set of
programs a waste of good effort (if at all we can muster people to
actually do the job).

In my oppinion, maintaining a software package should introduce as
little extra work on behalf of the debian maintainers as possible, and
having to keep a set of manpages in sync with a (potentially larger)
info document just in order to satisfy some highprofile policy, seems ahem
sub-optimal to me. 

I suggest we make the policy state that manpages must exist, but also
that such manpages are allowed to consist only of a reference to the
info system (probably under the condition that this points as
accurately as possible to the relevant node).

It then (of course) remains an option for those persons that can not
live without real manpages, to write and mantain such pages, either in
cooporation with the package maintainer or as a separate documentation
package. The point being that the initiative then must come from such
people, rather than pestering the life of the maintainer.


---------------------------+--------------------------------------------------
Christian Lynbech          | Telebit Communications A/S                       
                           | Fabrikvej 11, DK-8260 Viby J                 
Phone: +45 8628 8176       | email: chl@tbit.dk --- URL: http://www.tbit.dk
---------------------------+--------------------------------------------------
Hit the philistines three times over the head with the Elisp reference manual.
                                        - petonic@hal.com (Michael A. Petonic)


Reply to: