Re: PROPOSAL: complete list of documentation files, "man <packagename>", all man pages refer to said doc list in "See Also" section
Steve Greenland wrote:
> On 21-May-00, 20:23 (CDT), Jim Lynch <jim@laney.edu> wrote:
> >I expect enough documentation to use the package. As a maintainer and
> >potential non-maintainer uploader, I expect references to any docs the
> >maintainer used in the building of the package.
>
> Actually, if there is an INSTALL type document, I usually don't include
> it in the package. The user doesn't need to know how to configure and
> compile the softwarer -- that's the major point of a Debian package.
Steve, at one point I would have unhesitatingly agreed with what you said
above. But I've recently become involved in porting, and have repeatedly
been reduced to gnashing my teeth and using web search engines to try and
find the info used to configure and build packages. While the information
is certainly superflous in .debs, it would be very useful included in the
source.
Is there, or should there be, any policy wrt to documentation included in
source packages?
Regards,
Steve Gore
Reply to: