From mboxrd@z Thu Jan  1 00:00:00 1970
Received: from pigeon.gentoo.org ([208.92.234.80] helo=lists.gentoo.org)
	by finch.gentoo.org with esmtp (Exim 4.60)
	(envelope-from <gentoo-dev+bounces-49048-garchives=archives.gentoo.org@lists.gentoo.org>)
	id 1RcV9w-00043R-3a
	for garchives@archives.gentoo.org; Mon, 19 Dec 2011 04:49:08 +0000
Received: from pigeon.gentoo.org (localhost [127.0.0.1])
	by pigeon.gentoo.org (Postfix) with SMTP id 1427021C1D0;
	Mon, 19 Dec 2011 04:48:59 +0000 (UTC)
Received: from mail-yx0-f181.google.com (mail-yx0-f181.google.com [209.85.213.181])
	by pigeon.gentoo.org (Postfix) with ESMTP id D46F321C0DC
	for <gentoo-dev@lists.gentoo.org>; Mon, 19 Dec 2011 04:48:33 +0000 (UTC)
Received: by yenm3 with SMTP id m3so3540577yen.40
        for <gentoo-dev@lists.gentoo.org>; Sun, 18 Dec 2011 20:48:33 -0800 (PST)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
        d=gmail.com; s=gamma;
        h=message-id:date:from:user-agent:mime-version:to:subject:references
         :in-reply-to:content-type:content-transfer-encoding;
        bh=eCvNy83V/vXN8Z4gxfGE7nIMXgL2VsygBvJmjl/SyyE=;
        b=CdUhw+InYz6qvuVzuWMfViK2rGoo0Yx+yHVyqOohbvJ4XOo9tVdkibLk8k4ZmrA4Fe
         YvtBxt7dyK7JE8LwWxmN3rHY6AfdkxTJAXcyeYp6H2T8NgNh6InNgQdTthJPBO25IKPN
         IQYxUERBroPxQySV0P040C7vHMZh7VuVRCkhc=
Received: by 10.236.183.52 with SMTP id p40mr25782455yhm.19.1324270113235;
        Sun, 18 Dec 2011 20:48:33 -0800 (PST)
Received: from [192.168.2.5] (adsl-65-0-122-130.jan.bellsouth.net. [65.0.122.130])
        by mx.google.com with ESMTPS id s12sm18172and.15.2011.12.18.20.48.29
        (version=SSLv3 cipher=OTHER);
        Sun, 18 Dec 2011 20:48:30 -0800 (PST)
Message-ID: <4EEEC21B.6070602@gmail.com>
Date: Sun, 18 Dec 2011 22:48:27 -0600
From: Dale <rdalek1967@gmail.com>
User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:7.0.1) Gecko/20111022 Firefox/7.0.1 SeaMonkey/2.4.1
Precedence: bulk
List-Post: <mailto:gentoo-dev@lists.gentoo.org>
List-Help: <mailto:gentoo-dev+help@lists.gentoo.org>
List-Unsubscribe: <mailto:gentoo-dev+unsubscribe@lists.gentoo.org>
List-Subscribe: <mailto:gentoo-dev+subscribe@lists.gentoo.org>
List-Id: Gentoo Linux mail <gentoo-dev.gentoo.org>
X-BeenThere: gentoo-dev@lists.gentoo.org
Reply-to: gentoo-dev@lists.gentoo.org
MIME-Version: 1.0
To: gentoo-dev@lists.gentoo.org
Subject: Re: [gentoo-dev] RFC: deprecate /usr/share/doc/$PF
References: <CAL0O3aMcqPqDdDgbSodGfjigkd7v4dU=NrPv_CgYcyycnt1k4g@mail.gmail.com> <20206.32890.171045.50686@a1i15.kph.uni-mainz.de> <1324259574.12311.86.camel@rook> <20206.48172.238713.183104@a1i15.kph.uni-mainz.de>
In-Reply-To: <20206.48172.238713.183104@a1i15.kph.uni-mainz.de>
Content-Type: text/plain; charset=ISO-8859-1; format=flowed
Content-Transfer-Encoding: 7bit
X-Archives-Salt: 7e1887bd-f8e1-4bc7-b636-51980c85a0ee
X-Archives-Hash: d870e559fdc4592d5029f571e89a42fd

Ulrich Mueller wrote:
>>>>>> On Sun, 18 Dec 2011, Alexandre Rostovtsev wrote:
>>> 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. Think of
>> x11-terms/terminal:0 and gnustep-apps/terminal:0, or
>> app-misc/beagle:0 and sci-libs/beagle:0, or app-misc/nut:0 and
>> sys-power/nut:0. I could not think of any better solution than using
>> $CATEGORY/$PN-$SLOT.
> Thinking about it a little more, I believe that ${CATEGORY} shouldn't
> appear anywhere in the path of installed files, for the following
> reasons:
>
> 1. Users may not know the category of a package, therefore it's not
>     obvious for them where to find its documentation. (Think of it from
>     the perspective of a user on a multiuser system, who didn't install
>     the packages on that system.) OTOH, the name of the package (PN) is
>     obvious in most cases, since it will coincide with the upstream
>     name.
>
> 2. It doesn't play well with bash completion. When searching for
>     documentation of a specific package (and only knowing PN), one can
>     currently type the pathname up to PN and press tab which will
>     complete PVR. With CATEGORY _before_ PN this would no longer work.
>
> 3. CATEGORY and SLOT are Gentoo specific, related to the way how we
>     organise our packages. Neither of them should appear in the
>     directory structure of installed packages. The problems related to
>     package and slot moves (where CATEGORY or SLOT change) also show
>     that something is wrong with the approach. (BTW, in the current
>     system, PR is also Gentoo specific. It doesn't suffer from problems
>     with package moves though.)
>
>> Do you have a better proposal that does not rely on $PVR?
> Leave things as they are. It's not perfect, but IMHO your approach
> would create at least as many problems as it would solve.
> Alternatively, a minimal solution would be to drop only ${PR}, i.e.
> install documentation under /usr/share/doc/${P}.
>
> Ulrich
>
>

I like the logic in #1 as a user.  What if two packages have the same 
name but different categories tho?  It is rare but I do run into this 
from time to time.  I try to emerge something but am informed by emerge 
that I have to include the category for emerge to know exactly which 
package I want installed.

I do agree that docs are sometimes hard to find.  The only way I have 
any success is equery files <package name> then see where it put them or 
if there is none to find.

Back to my hole.

Dale

:-)  :-)

-- 
I am only responsible for what I said ... Not for what you understood or how you interpreted my words!

Miss the compile output?  Hint:
EMERGE_DEFAULT_OPTS="--quiet-build=n"