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

Re: Bug#39830: debian-policy: [PROPOSED]: get rid of undocumented(7) symlinks



Mark Brown <broonie@tardis.ed.ac.uk> writes:
> On Tue, Jun 22, 1999 at 03:32:35PM -0700, Chris Waters wrote:

> > Can you provide any positive arguments in *favor* of undocumented(7)?

> One thing undocumented(7) does is suggest some other ways to find
> documentation.

So could a two-line man page:

  NAME
        foo is a thingummy.

  DESCRIPTION
        foo is documented in /usr/doc/foo/ugly.html

In fact, this has the huge advantage of telling you where the
documentation for foo *is*, rather than merely listing all the places
where it *might* reside.
-- 
Chris Waters   xtifr@dsp.net | I have a truly elegant proof of the
      or    xtifr@debian.org | above, but it is too long to fit into
http://www.dsp.net/xtifr     | this .signature file.


Reply to: