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 ) id 1RcdIP-0000j2-64 for garchives@archives.gentoo.org; Mon, 19 Dec 2011 13:30:25 +0000 Received: from pigeon.gentoo.org (localhost [127.0.0.1]) by pigeon.gentoo.org (Postfix) with SMTP id DF45721C14D; Mon, 19 Dec 2011 13:30:12 +0000 (UTC) Received: from smtp.gentoo.org (smtp.gentoo.org [140.211.166.183]) by pigeon.gentoo.org (Postfix) with ESMTP id 91B62E06F4 for ; Mon, 19 Dec 2011 13:29:39 +0000 (UTC) Received: from localhost (localhost [127.0.0.1]) by smtp.gentoo.org (Postfix) with ESMTP id EB24A1B4018 for ; Mon, 19 Dec 2011 13:29:38 +0000 (UTC) X-Virus-Scanned: by amavisd-new using ClamAV at gentoo.org X-Spam-Flag: NO X-Spam-Score: -3.667 X-Spam-Level: X-Spam-Status: No, score=-3.667 tagged_above=-999 required=5.5 tests=[AWL=0.734, BAYES_00=-1.9, RP_MATCHES_RCVD=-2.499, SPF_HELO_PASS=-0.001, SPF_PASS=-0.001] autolearn=ham Received: from smtp.gentoo.org ([127.0.0.1]) by localhost (smtp.gentoo.org [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id 6ea0MwaHL_r5 for ; Mon, 19 Dec 2011 13:29:30 +0000 (UTC) Received: from lo.gmane.org (lo.gmane.org [80.91.229.12]) by smtp.gentoo.org (Postfix) with ESMTP id 633101B400B for ; Mon, 19 Dec 2011 13:29:30 +0000 (UTC) Received: from list by lo.gmane.org with local (Exim 4.69) (envelope-from ) id 1RcdHT-0005nq-7m for gentoo-dev@gentoo.org; Mon, 19 Dec 2011 14:29:27 +0100 Received: from ip68-231-22-224.ph.ph.cox.net ([68.231.22.224]) by main.gmane.org with esmtp (Gmexim 0.1 (Debian)) id 1AlnuQ-0007hv-00 for ; Mon, 19 Dec 2011 14:29:27 +0100 Received: from 1i5t5.duncan by ip68-231-22-224.ph.ph.cox.net with local (Gmexim 0.1 (Debian)) id 1AlnuQ-0007hv-00 for ; Mon, 19 Dec 2011 14:29:27 +0100 X-Injected-Via-Gmane: http://gmane.org/ To: gentoo-dev@lists.gentoo.org From: Duncan <1i5t5.duncan@cox.net> Subject: [gentoo-dev] Re: RFC: deprecate /usr/share/doc/$PF Date: Mon, 19 Dec 2011 13:29:15 +0000 (UTC) Message-ID: References: <20206.32890.171045.50686@a1i15.kph.uni-mainz.de> <1324259574.12311.86.camel@rook> <20206.48172.238713.183104@a1i15.kph.uni-mainz.de> <4EEEC21B.6070602@gmail.com> Precedence: bulk List-Post: List-Help: List-Unsubscribe: List-Subscribe: List-Id: Gentoo Linux mail X-BeenThere: gentoo-dev@lists.gentoo.org Reply-to: gentoo-dev@lists.gentoo.org Mime-Version: 1.0 Content-Type: text/plain; charset=UTF-8 X-Complaints-To: usenet@dough.gmane.org X-Gmane-NNTP-Posting-Host: ip68-231-22-224.ph.ph.cox.net User-Agent: Pan/0.135 (Tomorrow I'll Wake Up and Scald Myself with Tea; GIT ef87149 /st/portage/src/egit-src/pan2) Content-Transfer-Encoding: quoted-printable X-Archives-Salt: a5f19c1b-5b95-40bf-aff9-277e3e27a246 X-Archives-Hash: 8d967c6f5f477f485ffdacd77c8b7bd7 Dale posted on Sun, 18 Dec 2011 22:48:27 -0600 as excerpted: > Ulrich Mueller wrote: >> On Sun, 18 Dec 2011, Alexandre Rostovtsev wrote: >>> The problem is that ($PN, $CATEGORY) pairs are not unique. >> 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 > 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. At present that's semi-accounted-for by including version-revision. =20 Luckily, $PN clashes don't often have the same versions installed at the=20 same time, so including it helps avoid clashes on $PN only. The proposal= =20 removes version-revision, which would ordinarily be good, but in the=20 context of $PN clashes causes problems. I believe that's the rock upon which most previous similar proposals have= =20 foundered. > I do agree that docs are sometimes hard to find. The only way I have > any success is equery files then see where it put them o= r > if there is none to find. For docs, I used to have problems too, but it's been awhile, I think=20 because I've learned to work with the system, in this case, tab- completion (the next point), not against it. I do sometimes use equery=20 files or equery belongs to find where a package put files, but seldom for= =20 docs in the docdir, since I know where to look and can tab-complete for=20 them. But for what manpages a package includes, certainly, and over the=20 years I've found a number of commands I didn't know about, that way. =3D:= ^) >> 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. I often find myself doing equery list, simply to find the category, as=20 when reporting bugs or checking to see which binpkg versions I still have= =20 around, etc. But the various package trees (ebuild, binpkg, installed- db) are on filesystems that aren't normally mounted unless I'm working on= =20 them, on mds that likewise aren't normally assembled, and having to=20 assemble an md and mount a filesystem just to be able to do an equery=20 list, so I can lookup a doc of a package that's under some category name=20 I don't remember, just because someone broke the previously working bash- completion lookup method... Very much ungood! >> 3. CATEGORY and SLOT are Gentoo specific [and n]either of them should >> appear in the directory structure of installed packages. >> Leave things as they are. It's not perfect, but IMHO your approach >> would create at least as many problems as it would solve. Indeed. If a method allowing permanent bookmarking is desired, scripts that=20 create and update a tree of symlinks and/or uses existing portage phase=20 hooks has already been mentioned. Someone can package such a script and=20 as with any other package, people that want/need it can emerge and run it= =20 as necessary, without getting into the quagmire of confusing category=20 names, broken tab-completion and potential doc-file collisions that this=20 proposal is opening up. --=20 Duncan - List replies preferred. No HTML msgs. "Every nonfree program has a lord, a master -- and if you use the program, he is your master." Richard Stallman