[PATCH 10/14] Introduce ENVIRONMENT section
From: Bastien Roucariès <firstname.lastname@example.org>
Let use section for this man page
Signed-off-by: Bastien Roucariès <email@example.com>
man7/environ.7 | 92 +++++++++++++++++++++++++++-----------------------
1 file changed, 49 insertions(+), 43 deletions(-)
diff --git a/man7/environ.7 b/man7/environ.7
index da540a3e1..f7bdad6f0 100644
@@ -107,7 +107,55 @@ it inherits a
of its parent's environment.
-Common examples are:
+Environment variables may be placed in the shell's environment by the
+.BR sh (1),
+or by the
+command if you use
+.BR csh (1).
+The initial environment of the shell is populated in various ways,
+such as definitions from
+that are processed by
+.BR pam_env (8)
+for all users at login time (on systems that employ
+.BR pam (8)).
+In addition, various shell initialization scripts, such as the system-wide
+script and per-user initializations script may include commands
+that add variables to the shell's environment;
+see the manual page of your preferred shell for details.
+Bourne-style shells support the syntax
+ NAME=value command
+to create an environment variable definition only in the scope
+of the process that executes
+.IR command .
+Multiple variable definitions, separated by white space, may precede
+.IR command .
+Arguments may also be placed in the
+environment at the point of an
+.BR exec (3).
+A C program can manipulate its environment using the functions
+.BR getenv (3),
+.BR putenv (3),
+.BR setenv (3),
+.BR unsetenv (3).
+What follows is a list of environment variables typically seen on a
+system. This list is incomplete and includes only common variables seen
+by average users in their day-to-day routine.
+Environment variables specific to a particular program or library function
+are documented in the ENVIRONMENT section of the appropriate manual page.
+Common examples of environment variables are:
The name of the logged-in user (used by some BSD-derived programs).
@@ -199,48 +247,6 @@ command shall be valid.
.\" The user's preferred utility to browse URLs. Sequence of colon-separated
.\" browser commands. See http://www.catb.org/\(tiesr/BROWSER/ .
-Names may be placed in the shell's environment by the
-.BR sh (1),
-or by the
-command if you use
-.BR csh (1).
-The initial environment of the shell is populated in various ways,
-such as definitions from
-that are processed by
-.BR pam_env (8)
-for all users at login time (on systems that employ
-.BR pam (8)).
-In addition, various shell initialization scripts, such as the system-wide
-script and per-user initializations script may include commands
-that add variables to the shell's environment;
-see the manual page of your preferred shell for details.
-Bourne-style shells support the syntax
- NAME=value command
-to create an environment variable definition only in the scope
-of the process that executes
-.IR command .
-Multiple variable definitions, separated by white space, may precede
-.IR command .
-Arguments may also be placed in the
-environment at the point of an
-.BR exec (3).
-A C program can manipulate its environment using the functions
-.BR getenv (3),
-.BR putenv (3),
-.BR setenv (3),
-.BR unsetenv (3).
Note that the behavior of many programs and library routines is
influenced by the presence or value of certain environment variables.
Examples include the following: