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 88B5C1396D0 for ; Mon, 9 Oct 2017 17:31:15 +0000 (UTC) Received: from pigeon.gentoo.org (localhost [127.0.0.1]) by pigeon.gentoo.org (Postfix) with SMTP id 4C289E0C11; Mon, 9 Oct 2017 17:31:13 +0000 (UTC) Received: from smtp.gentoo.org (mail.gentoo.org [IPv6:2001:470:ea4a:1:5054:ff:fec7:86e4]) (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 1C965E0C11 for ; Mon, 9 Oct 2017 17:31:13 +0000 (UTC) Received: from oystercatcher.gentoo.org (unknown [IPv6:2a01:4f8:202:4333:225:90ff:fed9:fc84]) (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 7F86D33C1EB for ; Mon, 9 Oct 2017 17:31:11 +0000 (UTC) Received: from localhost.localdomain (localhost [IPv6:::1]) by oystercatcher.gentoo.org (Postfix) with ESMTP id 0BF5090A2 for ; Mon, 9 Oct 2017 17:31:10 +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: <1507569128.7c59313e9621a2ca7d93ae5a60e3460198766f56.ulm@gentoo> Subject: [gentoo-commits] proj/pms:eapi-7 commit in: / X-VCS-Repository: proj/pms X-VCS-Files: eapi-differences.tex pkg-mgr-commands.tex X-VCS-Directories: / X-VCS-Committer: ulm X-VCS-Committer-Name: Ulrich Müller X-VCS-Revision: 7c59313e9621a2ca7d93ae5a60e3460198766f56 X-VCS-Branch: eapi-7 Date: Mon, 9 Oct 2017 17:31:10 +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: 30472952-f51c-4728-bf42-c3dce96cda20 X-Archives-Hash: 346c3266a8fbae158a32b710489d3831 commit: 7c59313e9621a2ca7d93ae5a60e3460198766f56 Author: Michał Górny gentoo org> AuthorDate: Thu Sep 28 14:10:20 2017 +0000 Commit: Ulrich Müller gentoo org> CommitDate: Mon Oct 9 17:12:08 2017 +0000 URL: https://gitweb.gentoo.org/proj/pms.git/commit/?id=7c59313e EAPI 7 disallows stdout output of output functions Bug: https://bugs.gentoo.org/483240 eapi-differences.tex | 4 ++++ pkg-mgr-commands.tex | 17 +++++++++++------ 2 files changed, 15 insertions(+), 6 deletions(-) diff --git a/eapi-differences.tex b/eapi-differences.tex index 8a1e55a..0c47d9b 100644 --- a/eapi-differences.tex +++ b/eapi-differences.tex @@ -41,6 +41,9 @@ of this document for a complete table of previous EAPIs. \bottomrule \endlastfoot +Output cmds can use stdout & \compactfeatureref{output-no-stdout} & + Yes & Yes & Yes & Yes & No \\ + \t{eqawarn} & \compactfeatureref{eqawarn} & No & No & No & No & Yes \\ @@ -391,6 +394,7 @@ EAPI 7 is EAPI 6 with the following changes: \item \t{dohtml} banned, \featureref{banned-commands}. \item Version manipulation and comparison functions added, \featureref{ver-functions}. \item \t{eqawarn} added, \featureref{eqawarn}. +\item Output commands can no longer use stdout, \featureref{output-no-stdout}. \end{compactitem} \ChangeWhenAddingAnEAPI{7} diff --git a/pkg-mgr-commands.tex b/pkg-mgr-commands.tex index 91f38c0..76f5bff 100644 --- a/pkg-mgr-commands.tex +++ b/pkg-mgr-commands.tex @@ -114,8 +114,12 @@ These commands display messages to the user. Unless otherwise stated, the entire used as a message, with backslash-escaped characters interpreted as for the \t{echo -e} command of bash, notably \t{\textbackslash t} for a horizontal tab, \t{\textbackslash n} for a new line, and \t{\textbackslash\textbackslash} for a literal backslash. Ebuilds must not run any of these commands -once the current phase function has returned. Unless otherwise noted, output may be sent to stdout, -stderr or some other appropriate facility. +once the current phase function has returned. + +\featurelabel{output-no-stdout} Unless otherwise noted, output may be sent to stderr or some other +appropriate facility. In EAPIs listed in table~\ref{tab:output-commands} as not allowing stdout +output, using stdout as an output facility is forbidden. + \begin{description} \item[einfo] Displays an informational message. \item[einfon] Displays an informational message without a trailing newline. @@ -139,13 +143,14 @@ stderr or some other appropriate facility. \ChangeWhenAddingAnEAPI{7} \begin{centertable}{Output commands for EAPIs} \label{tab:output-commands} - \begin{tabular}{ll} + \begin{tabular}{lll} \toprule \multicolumn{1}{c}{\textbf{EAPI}} & - \multicolumn{1}{c}{\textbf{\t{eqawarn}?}} \\ + \multicolumn{1}{c}{\textbf{\t{eqawarn}?}} & + \multicolumn{1}{c}{\textbf{can output to stdout?}} \\ \midrule - 0, 1, 2, 3, 4, 5, 6 & No \\ - 7 & Yes \\ + 0, 1, 2, 3, 4, 5, 6 & No & Yes \\ + 7 & Yes & No \\ \bottomrule \end{tabular} \end{centertable}