Re: fixing up /usr/doc
Ben Gertzfield wrote:
> >>>>> "Zack" == Zack Brown <zbrown@lynx.neu.edu> writes:
>
> Zack> why not make /usr/doc a place where real
> Zack> documentation (and *only* real documentation) can be
> Zack> found. Right now users have to sift through endless stubs to
> Zack> get to the real stuff.
>
> The point of /usr/doc/packagename/ is not only the docs, but as you
> must have noticed, the copyright and changelog information.
Then we should have a tree called
/usr/doc--we-really-mean-it/
> All Debian packages must come with copyright information in
> /usr/doc/packagename/.
It has also bothered me that Debian packages have files called
`copyright' but no `license' files.
It would be (IMHO) a _good_ thing to have copyright,
README.Debian and changlogs files in some other (better-named)
directory, and have stuff put in /usr/doc/ only if they were
relevant docs (html, ascii, examples, etc). It would make the
documentation tree more informative.
Facts: - not every package has a man page
- not every html docs are registered
- The huge number of entries in /usr/doc make it
difficult to detect which package have examples there
(and why would we _have_ to read every man page to find
out?)
- the current content of /usr/doc is non-intuitive to new
users (breaks the rule of least surprise)
- we should be trying to make Debian easier for users.
Peter
Reply to: