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

Re: Which directory to use for packagename-doc documentation files?



On Tue, Jul 24, 2001 at 04:24:22PM -0500, Steve Greenland wrote:
> I think my personal favorite would be that package foo contain the
> symlink /usr/share/doc/foo/docs->../../foo-doc. I can see that others
> might not like it though. If foo-doc isn't installed, the broken link is
> ugly, but it's also a big hint that 'apt-get install foo-doc' might be
> useful.

Why not put the symlink in foo-doc instead of foo? That way, if you've
just got foo installed, you don't see any docs and you think "Hmmm,
wonder if there's a foo-doc package then?", and if you've got the docs
installed, you can just look in /usr/share/doc/foo/docs and find it.

Or since "docs" is a bit redundant, maybe it'd be better to say that "large"
HTML, .ps.gz, .pdf, etc docs should be the only things split into separate
packages (-doc, -doc-html, whatever), and to have /usr/share/doc/foo/html
as the symlink instead.

Cheers,
aj

-- 
Anthony Towns <aj@humbug.org.au> <http://azure.humbug.org.au/~aj/>
I don't speak for anyone save myself. GPG signed mail preferred.

``_Any_ increase in interface difficulty, in exchange for a benefit you
  do not understand, cannot perceive, or don't care about, is too much.''
                      -- John S. Novak, III (The Humblest Man on the Net)

Attachment: pgp4CnTXuXc8q.pgp
Description: PGP signature


Reply to: