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 1RcZ6X-00032P-Pb for garchives@archives.gentoo.org; Mon, 19 Dec 2011 09:01:54 +0000 Received: from pigeon.gentoo.org (localhost [127.0.0.1]) by pigeon.gentoo.org (Postfix) with SMTP id 99BFD21C270; Mon, 19 Dec 2011 09:01:44 +0000 (UTC) Received: from smtp.gentoo.org (smtp.gentoo.org [140.211.166.183]) by pigeon.gentoo.org (Postfix) with ESMTP id DED4921C0A9 for ; Mon, 19 Dec 2011 09:01:16 +0000 (UTC) Received: from pomiocik.lan (77-253-147-68.adsl.inetia.pl [77.253.147.68]) (using TLSv1 with cipher DHE-RSA-AES128-SHA (128/128 bits)) (No client certificate requested) (Authenticated sender: mgorny) by smtp.gentoo.org (Postfix) with ESMTPSA id 234AE1B4003; Mon, 19 Dec 2011 09:01:14 +0000 (UTC) Date: Mon, 19 Dec 2011 10:02:07 +0100 From: =?UTF-8?B?TWljaGHFgiBHw7Nybnk=?= To: gentoo-dev@lists.gentoo.org Cc: tetromino@gentoo.org Subject: Re: [gentoo-dev] RFC: deprecate /usr/share/doc/$PF Message-ID: <20111219100207.0a109cc1@pomiocik.lan> In-Reply-To: <1324276860.12311.177.camel@rook> References: <20206.32890.171045.50686@a1i15.kph.uni-mainz.de> <1324259574.12311.86.camel@rook> <20206.48172.238713.183104@a1i15.kph.uni-mainz.de> <1324276860.12311.177.camel@rook> Organization: Gentoo X-Mailer: Claws Mail 3.7.10 (GTK+ 2.24.8; x86_64-pc-linux-gnu) 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: multipart/signed; micalg=PGP-SHA256; boundary="Sig_/Egb07Xfs7HB6fW3iXc=YOLU"; protocol="application/pgp-signature" X-Archives-Salt: 8c82e0cd-bc28-4b49-8d0b-fa2c0e80837e X-Archives-Hash: e99eedb23fd413bad5089202305f43f1 --Sig_/Egb07Xfs7HB6fW3iXc=YOLU Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: quoted-printable On Mon, 19 Dec 2011 01:41:00 -0500 Alexandre Rostovtsev wrote: > Using /usr/share/doc/$PN-$SLOT with exceptions for packages that have > the same ($PN, $SLOT) but different categories would not scale: it > turns out there are >100 of them in the main tree. And I hope there will be more. We should seriously start splitting packages rather than using old Gentoo bloat like IUSE=3D'perl python foobar foobaz'. > Fortunately, there *is* a neat solution. >=20 > Symlinks. Symlinks are never neat. In this particular case, they just mean someone has failed horribly and now is hoping to fix it taking the path of least resistance. > > 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. >=20 > You are correct that categories are Gentoo-specific and are therefore > not ideal for installed paths. However, for generating a stable path > to documentation files, one that does not shift on version bumps and > revbumps, there doesn't seem to be any alternative. To be honest, the whole ${PF} is Gentoo-specific. Package names not necessarily follow upstream ones; sometimes we need to change versions as well to match ${PV} semantics or logic. Perl modules are quite a large case here. Sometimes packages in different categories collide. Right now, devs have to be aware not to install colliding docs -- usually through renaming files. Using category will at least partially fix this. Shifting is unavoidable. SLOTs can change, categories can change, package names can change. Of course, all the mentioned cases are much rarer than PF changing but -- as pointed out before -- these could change without reinstalling packages. If we decided to use such names, the most correct approach would be to have PM handle docmoves as well. But -- on the other hand -- there will be always some hardwired paths which will be updated only on real package rebuild... --=20 Best regards, Micha=C5=82 G=C3=B3rny --Sig_/Egb07Xfs7HB6fW3iXc=YOLU Content-Type: application/pgp-signature; name=signature.asc Content-Disposition: attachment; filename=signature.asc -----BEGIN PGP SIGNATURE----- Version: GnuPG v2.0.18 (GNU/Linux) iJwEAQEIAAYFAk7u/ZAACgkQfXuS5UK5QB3OLAQAk8ZMgXowjXcqrzOYqkXjoX5a HR20TPtjcXAS4qDHpd7FGOwK98wAq131bH79UeO3IW2foLULnQ7YEYvhpFm9XjLD 5iMWupFlc+xcoyN15nfEFsclcnl9ItcAXOgD7jQTj7ZPJexilasHLiwJCZcKfCuX 0z+KqUMPvNTy2/9V5lA= =wtoq -----END PGP SIGNATURE----- --Sig_/Egb07Xfs7HB6fW3iXc=YOLU--