commit: 01346659dfaf4057107dacc38bbeb7e7b0fc5e4f
Author: Ulrich Müller <ulm <AT> gentoo <DOT> org>
AuthorDate: Wed Oct 21 16:47:05 2015 +0000
Commit: Ulrich Müller <ulm <AT> gentoo <DOT> org>
CommitDate: Sun Nov 8 19:29:19 2015 +0000
URL: https://gitweb.gentoo.org/proj/pms.git/commit/?id=01346659
Recommend setting the bash compatibility level.
ebuild-format.tex | 5 ++++-
1 file changed, 4 insertions(+), 1 deletion(-)
diff --git a/ebuild-format.tex b/ebuild-format.tex
index 61e3437..db6d7a1 100644
--- a/ebuild-format.tex
+++ b/ebuild-format.tex
@@ -3,7 +3,10 @@
\featurelabel{bash-version} The ebuild file format is in its basic form a
subset of the format of
a bash script. The interpreter is assumed to be GNU bash, version as listed in
-table~\ref{tab:bash-version}, or any later version.
+table~\ref{tab:bash-version}, or any later version. If possible, the package
manager should set
+the shell's compatibility level to the exact version specified. It must ensure
that any such
+compatibility settings (e.g. the \t{BASH\_COMPAT} variable) are not exported
to external programs.
+
The file encoding must be UTF-8 with Unix-style newlines. When sourced, the
ebuild must define
certain variables and functions (see sections~\ref{sec:ebuild-vars}
and~\ref{sec:ebuild-functions}
for specific information), and must not call any external programs, write
anything to standard
