From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from lists.gentoo.org (pigeon.gentoo.org [208.92.234.80]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by finch.gentoo.org (Postfix) with ESMTPS id 448BD1396D1 for ; Sun, 8 Oct 2017 16:05:26 +0000 (UTC) Received: from pigeon.gentoo.org (localhost [127.0.0.1]) by pigeon.gentoo.org (Postfix) with SMTP id 6437E2BC007; Sun, 8 Oct 2017 16:05:25 +0000 (UTC) Received: from smtp.gentoo.org (smtp.gentoo.org [140.211.166.183]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by pigeon.gentoo.org (Postfix) with ESMTPS id 362342BC007 for ; Sun, 8 Oct 2017 16:05:25 +0000 (UTC) Received: from oystercatcher.gentoo.org (oystercatcher.gentoo.org [148.251.78.52]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.gentoo.org (Postfix) with ESMTPS id 24F3F33BF47 for ; Sun, 8 Oct 2017 16:05:24 +0000 (UTC) Received: from localhost.localdomain (localhost [IPv6:::1]) by oystercatcher.gentoo.org (Postfix) with ESMTP id B87D7909E for ; Sun, 8 Oct 2017 16:05:22 +0000 (UTC) From: "Ulrich Müller" To: gentoo-commits@lists.gentoo.org Content-Transfer-Encoding: 8bit Content-type: text/plain; charset=UTF-8 Reply-To: gentoo-dev@lists.gentoo.org, "Ulrich Müller" Message-ID: <1507477675.bd52ad528d3fc7a6c178928c039b0b7097dec816.ulm@gentoo> Subject: [gentoo-commits] proj/pms:master commit in: / X-VCS-Repository: proj/pms X-VCS-Files: appendices.tex X-VCS-Directories: / X-VCS-Committer: ulm X-VCS-Committer-Name: Ulrich Müller X-VCS-Revision: bd52ad528d3fc7a6c178928c039b0b7097dec816 X-VCS-Branch: master Date: Sun, 8 Oct 2017 16:05:22 +0000 (UTC) Precedence: bulk List-Post: List-Help: List-Unsubscribe: List-Subscribe: List-Id: Gentoo Linux mail X-BeenThere: gentoo-commits@lists.gentoo.org X-Archives-Salt: 1b3459a9-d159-4433-ad0d-5cf81203d396 X-Archives-Hash: 06a4ff7e549f9f801241f56de42a85c2 commit: bd52ad528d3fc7a6c178928c039b0b7097dec816 Author: Ulrich Müller gentoo org> AuthorDate: Sun Aug 27 11:38:45 2017 +0000 Commit: Ulrich Müller gentoo org> CommitDate: Sun Oct 8 15:47:55 2017 +0000 URL: https://gitweb.gentoo.org/proj/pms.git/commit/?id=bd52ad52 Appendix: Split off retroactive changes from historical curiosities. appendices.tex | 25 ++++++++++++++----------- 1 file changed, 14 insertions(+), 11 deletions(-) diff --git a/appendices.tex b/appendices.tex index 8c97734..dd40041 100644 --- a/appendices.tex +++ b/appendices.tex @@ -26,12 +26,13 @@ been abused in the past. \chapter{Historical Curiosities} -The items described in this chapter are included for information only. Unless otherwise noted, -they were deprecated or abandoned long before \t{EAPI} was introduced. Ebuilds must not use these -features, and package managers should not be changed to support them. +\section{Long-obsolete Features} -\section{If-else USE Blocks} +The items described in this section are included for information only. Unless otherwise noted, they +were deprecated or abandoned long before EAPI was introduced. Ebuilds must not use these features, +and package managers should not be changed to support them. +\subsection{If-else USE blocks} Historically, Portage supported if-else use conditionals, as shown by listing~\ref{lst:if-else-use-listing}. The block before the colon would be taken if the condition was met, and the block after the colon would be taken if the condition was not met. @@ -49,27 +50,29 @@ DEPEND=" \end{verbatim} \end{listing} -\section{cvs Versions} - +\subsection{CVS versions} Portage has very crude support for CVS packages. The package \t{foo} could contain a file named \t{foo-cvs.1.2.3.ebuild}. This version would order \e{higher} than any non-CVS version (including \t{foo-2.ebuild}). This feature has not seen real world use and breaks versioned dependencies, so it must not be used. -\section{use.defaults} - +\subsection{use.defaults} The \t{use.defaults} file in the profile directory was used to implement `autouse'---switching USE flags on or off depending upon which packages are installed. It was deprecated long ago and finally removed in 2009. -\section{Old-style Virtuals} +\section{Retroactive Changes} + +In some exceptional cases, changes to the specification have been approved by the Gentoo Council +without introducing a new EAPI. This section lists such retroactive changes. +\subsection{Old-style virtuals} Historically, virtuals were special packages rather than regular ebuilds. An ebuild could specify in the \t{PROVIDE} metadata that it supplied certain virtuals, and the package manager had to bear this in mind when handling dependencies. -Old-style virtuals were supported by EAPIs \t{0}, \t{1}, \t{2}, \t{3} and \t{4}, and were phased out -via GLEP 37~\cite{Glep37}. +Old-style virtuals were supported by EAPIs \t{0}, \t{1}, \t{2}, \t{3} and \t{4}. They were phased +out via GLEP 37~\cite{Glep37} and finally removed in 2011. % vim: set filetype=tex fileencoding=utf8 et tw=100 spell spelllang=en :