Gentoo Archives: gentoo-dev

From: Maciej Mrozowski <reavertm@×××××.com>
To: gentoo-dev@l.g.o
Subject: Re: [gentoo-dev] RFC: deprecate /usr/share/doc/$PF
Date: Wed, 21 Dec 2011 01:45:02
In Reply to: Re: [gentoo-dev] RFC: deprecate /usr/share/doc/$PF by Alexandre Rostovtsev
On Monday 19 of December 2011 02:52:54 Alexandre Rostovtsev wrote:
> On Mon, 2011-12-19 at 01:08 +0100, Ulrich Mueller wrote: > > [Why are there different Reply-To: headers in -dev and in -pms MLs? > > Following up to both lists.] > > I apologize for the mess; I had intended to bring the question up before > a wider audience, but failed to think through the consequences of two > mailing lists ending up in the reply-to. > > For the sake of keeping discussion in one thread, I ask that further > replies should be made to gentoo-dev, not gentoo-pms. > > > How do you handle FEATURES="nodoc" if you spread the documentation all > > over the filesystem? Should Portage learn about all the special cases? > > IMHO it would make more sense to leave the documentation under > > /usr/share/doc and either configure the documentation viewer to find > > it there, or (if that's not possible) create symlinks. > > It's not "all over the filesystem"; in practice, the number of locations > I believe is fairly small (/usr/share/gtk-doc and /usr/lib/monodoc for > API documentation, and /usr/share/help, /usr/share/omf, > and /usr/share/doc/HTML for end-user help files are the only ones that I > know of), and adding them to portage's nodoc list seems much easier than > editing hundreds of ebuilds that already install docs there. > > Documentation in Gentoo-specific /usr/share/doc subdirectories would not > be able to link to documentation pages in other packages without > fragile, hard-to-maintain scripts - and even with the best scripts, > things would break on package renames. Symlinks could work, but (if the > nodoc situation is resolved) would give package maintainers extra work > for no real benefit. > > > Can we please avoid the bloat of another directory level here? > > ${CATEGORY}/${PN} will be even longer than ${PF} in most cases. > > The problem is that ($PN, $CATEGORY) pairs are not unique.
I still think we should even make PN an unique identifier in order to be able to purge categories... that's different story though... -- regards MM


File name MIME type
signature.asc application/pgp-signature


Subject Author
Re: [gentoo-dev] RFC: deprecate /usr/share/doc/$PF Mike Frysinger <vapier@g.o>