From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from lists.gentoo.org (pigeon.gentoo.org [208.92.234.80]) by finch.gentoo.org (Postfix) with ESMTP id C7E07138010 for ; Fri, 14 Sep 2012 06:16:49 +0000 (UTC) Received: from pigeon.gentoo.org (localhost [127.0.0.1]) by pigeon.gentoo.org (Postfix) with SMTP id 4149521C027; Fri, 14 Sep 2012 06:14:57 +0000 (UTC) Received: from smtp.gentoo.org (smtp.gentoo.org [140.211.166.183]) by pigeon.gentoo.org (Postfix) with ESMTP id 02B2D21C027 for ; Fri, 14 Sep 2012 06:14:51 +0000 (UTC) Received: from hornbill.gentoo.org (hornbill.gentoo.org [94.100.119.163]) (using TLSv1 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by smtp.gentoo.org (Postfix) with ESMTPS id 3C9C133D72F for ; Fri, 14 Sep 2012 06:14:51 +0000 (UTC) Received: from localhost.localdomain (localhost [127.0.0.1]) by hornbill.gentoo.org (Postfix) with ESMTP id 4406EE5450 for ; Fri, 14 Sep 2012 06:14:48 +0000 (UTC) From: "Ulrich Mueller" 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 Mueller" Message-ID: <1347517696.6214dc36bff09e474d9813c542638a668dcff47e.ulm@gentoo> Subject: [gentoo-commits] proj/pms:master commit in: / X-VCS-Repository: proj/pms X-VCS-Files: ebuild-env-vars.tex X-VCS-Directories: / X-VCS-Committer: ulm X-VCS-Committer-Name: Ulrich Mueller X-VCS-Revision: 6214dc36bff09e474d9813c542638a668dcff47e X-VCS-Branch: master Date: Fri, 14 Sep 2012 06:14:48 +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: 8b0c3417-4218-42ad-8f2f-52605cbc19e0 X-Archives-Hash: 4b2ecaa3820e9d919cf8edeb25b3df77 commit: 6214dc36bff09e474d9813c542638a668dcff47e Author: Ciaran McCreesh googlemail com> AuthorDate: Sun May 6 17:41:34 2012 +0000 Commit: Ulrich Mueller gentoo org> CommitDate: Thu Sep 13 06:28:16 2012 +0000 URL: http://git.overlays.gentoo.org/gitweb/?p=proj/pms.git;a=commit;h=6214dc36 Split up big table into two littler tables. --- ebuild-env-vars.tex | 63 ++++++++++++++++++++++++++++++++------------------ 1 files changed, 40 insertions(+), 23 deletions(-) diff --git a/ebuild-env-vars.tex b/ebuild-env-vars.tex index 428cb3a..060d502 100644 --- a/ebuild-env-vars.tex +++ b/ebuild-env-vars.tex @@ -76,7 +76,7 @@ variable. \featurelabel{aa} All source files that could be available for the package, including any that are disabled in \t{A} because of USE conditionals. The value is calculated from the base names of each element of the \t{SRC\_URI} ebuild metadata variable. Only for EAPIs listed in - table~\ref{tab:env-vars-table} as supporting \t{AA}. \\ + table~\ref{tab:removed-env-vars-table} as supporting \t{AA}. \\ \t{FILESDIR} & \t{src\_*}\footnote{Not necessarily present when installing from a binary package} & No & @@ -177,7 +177,7 @@ variable. \t{pkg\_postrm}, \t{pkg\_info}, \t{pkg\_pretend} according to the top level ebuild function that was executed by the package manager. May be unset or any single word that is not any of the above when the ebuild is being sourced for other (e.\,g.\ metadata or QA) purposes. Only for - EAPIs listed in table~\ref{tab:env-vars-table} as supporting \t{EBUILD\_PHASE\_FUNC}. \\ + EAPIs listed in table~\ref{tab:added-env-vars-table} as supporting \t{EBUILD\_PHASE\_FUNC}. \\ \t{WORKDIR} & \t{src\_*}, global~scope & Yes & @@ -195,49 +195,65 @@ variable. Yes & \featurelabel{kv} The version of the running kernel at the time the ebuild was first executed, as returned by the \t{uname~-r} command or equivalent. May be modified by ebuilds. Only for - EAPIs listed in table~\ref{tab:env-vars-table} as supporting \t{KV}. \\ + EAPIs listed in table~\ref{tab:removed-env-vars-table} as supporting \t{KV}. \\ \t{MERGE\_TYPE} & \t{pkg\_*} & No & \featurelabel{merge-type} The type of package that is being merged. Possible values are: \t{source} if building and installing a package from source, \t{binary} if installing a binary package, and \t{buildonly} if building a binary package without installing it. Only for EAPIs - listed in table~\ref{tab:env-vars-table} as supporting \t{MERGE\_TYPE}. \\ + listed in table~\ref{tab:added-env-vars-table} as supporting \t{MERGE\_TYPE}. \\ \t{REPLACING\_VERSIONS} & \t{pkg\_*} (see text) & Yes & A whitespace-separated list of versions of this package (including revision, if specified) that are being replaced (uninstalled or overwritten) as a result of this install. See - section~\ref{sec:replacing-versions}. Only for EAPIs listed in table~\ref{tab:env-vars-table} + section~\ref{sec:replacing-versions}. Only for EAPIs listed in table~\ref{tab:added-env-vars-table} as supporting \t{REPLACING\_VERSIONS}. \\ \t{REPLACED\_BY\_VERSION} & \t{pkg\_prerm}, \t{pkg\_postrm} & Yes & The single version of this package (including revision, if specified) that is replacing us, if we are being uninstalled as part of an install, or an empty string otherwise. See - section~\ref{sec:replacing-versions}. Only for EAPIs listed in table~\ref{tab:env-vars-table} + section~\ref{sec:replacing-versions}. Only for EAPIs listed in table~\ref{tab:added-env-vars-table} as supporting \t{REPLACED\_BY\_VERSION}. \end{longtable} \end{landscape} \ChangeWhenAddingAnEAPI{5} -\begin{centertable}{EAPIs supporting various env variables} \label{tab:env-vars-table} - \begin{tabular}{ l l l l l l l } +\begin{centertable}{EAPIs supporting various added env variables} \label{tab:added-env-vars-table} + \begin{tabular}{ l l l l l } \toprule \multicolumn{1}{c}{\textbf{EAPI}} & - \multicolumn{1}{c}{\textbf{\t{AA}?}} & - \multicolumn{1}{c}{\textbf{\t{KV}?}} & \multicolumn{1}{c}{\textbf{\t{MERGE\_TYPE}?}} & \multicolumn{1}{c}{\textbf{\t{REPLACING\_VERSIONS}?}} & \multicolumn{1}{c}{\textbf{\t{REPLACED\_BY\_VERSION}?}} & \multicolumn{1}{c}{\textbf{\t{EBUILD\_PHASE\_FUNC}?}} \\ \midrule - \t{0} & Yes & Yes & No & No & No & No \\ - \t{1} & Yes & Yes & No & No & No & No \\ - \t{2} & Yes & Yes & No & No & No & No \\ - \t{3} & Yes & Yes & No & No & No & No \\ - \t{4} & No & No & Yes & Yes & Yes & No \\ - \t{5} & No & No & Yes & Yes & Yes & Yes \\ + \t{0} & No & No & No & No \\ + \t{1} & No & No & No & No \\ + \t{2} & No & No & No & No \\ + \t{3} & No & No & No & No \\ + \t{4} & Yes & Yes & Yes & No \\ + \t{5} & Yes & Yes & Yes & Yes \\ + \bottomrule + \end{tabular} +\end{centertable} + +\ChangeWhenAddingAnEAPI{5} +\begin{centertable}{EAPIs supporting various removed env variables} \label{tab:removed-env-vars-table} + \begin{tabular}{ l l l } + \toprule + \multicolumn{1}{c}{\textbf{EAPI}} & + \multicolumn{1}{c}{\textbf{\t{AA}?}} & + \multicolumn{1}{c}{\textbf{\t{KV}?}} \\ + \midrule + \t{0} & Yes & Yes \\ + \t{1} & Yes & Yes \\ + \t{2} & Yes & Yes \\ + \t{3} & Yes & Yes \\ + \t{4} & No & No \\ + \t{5} & No & No \\ \bottomrule \end{tabular} \end{centertable} @@ -343,17 +359,18 @@ installing a package. Details are beyond the scope of this specification. \subsection{\t{REPLACING\_VERSIONS} and \t{REPLACED\_BY\_VERSION}} \label{sec:replacing-versions} -\featurelabel{replace-version-vars} In EAPIs listed in table~\ref{tab:env-vars-table} as supporting -it, the \t{REPLACING\_VERSIONS} variable shall be defined in \t{pkg\_preinst} and \t{pkg\_postinst}. -In addition, it \e{may} be defined in \t{pkg\_pretend} and \t{pkg\_setup}, although ebuild authors -should take care to handle binary package creation and installation correctly when using it in these -phases. +\featurelabel{replace-version-vars} In EAPIs listed in table~\ref{tab:added-env-vars-table} as +supporting it, the \t{REPLACING\_VERSIONS} variable shall be defined in \t{pkg\_preinst} and +\t{pkg\_postinst}. In addition, it \e{may} be defined in \t{pkg\_pretend} and \t{pkg\_setup}, +although ebuild authors should take care to handle binary package creation and installation +correctly when using it in these phases. \t{REPLACING\_VERSIONS} is a list, not a single optional value, to handle pathological cases such as installing \t{foo-2:2} to replace \t{foo-2:1} and \t{foo-3:2}. -In EAPIs listed in table~\ref{tab:env-vars-table} as supporting it, the \t{REPLACED\_BY\_VERSION} -variable shall be defined in \t{pkg\_prerm} and \t{pkg\_postrm}. It shall contain at most one value. +In EAPIs listed in table~\ref{tab:added-env-vars-table} as supporting it, the +\t{REPLACED\_BY\_VERSION} variable shall be defined in \t{pkg\_prerm} and \t{pkg\_postrm}. It shall +contain at most one value. \subsection{Offset-prefix variables \t{EPREFIX}, \t{EROOT} and \t{ED}} \label{sec:offset-vars}