From: Bastien Roucariès <ro...@debian.org>

Document the name=value system and that nul byte is forbidden

Signed-off-by: Bastien Roucariès <ro...@debian.org>
---
 man7/environ.7 | 12 +++++++++---
 1 file changed, 9 insertions(+), 3 deletions(-)

diff --git a/man7/environ.7 b/man7/environ.7
index f9e49a572..f2786fa09 100644
--- a/man7/environ.7
+++ b/man7/environ.7
@@ -90,6 +90,15 @@ current language, etc., and a user can define additional 
variables for other pur
 The set of all environment variables that have values is collectively known as
 the process environment or simply the environment.
 .PP
+By convention, the strings in
+.I environ
+have the form "\fIname\fP\fB=\fP\fIvalue\fP".
+Names of environment variables are case-sensitive and must not contain
+the character "\fB=\fP". The values of environment variables can be anything
+that can be represented as a string. A value and a name must not contain an
+embedded null byte (\(aq\e0\(aq),
+since this is assumed to terminate the string.
+.PP
 This array of strings is made available to the process by the
 .BR exec (3)
 call that started the process.
@@ -99,9 +108,6 @@ it inherits a
 .I copy
 of its parent's environment.
 .PP
-By convention the strings in
-.I environ
-have the form "\fIname\fP\fB=\fP\fIvalue\fP".
 Common examples are:
 .TP
 .B USER
-- 
2.29.2

Reply via email to