[PATCH 11/14] Reorganize the different environment section
From: Bastien Roucariès <rouca@debian.org>
Introduce a Posix defined environment, other and internalization
Signed-off-by: Bastien Roucariès <rouca@debian.org>
---
man7/environ.7 | 69 +++++++++++++++++++++++++-------------------------
1 file changed, 34 insertions(+), 35 deletions(-)
diff --git a/man7/environ.7 b/man7/environ.7
index f7bdad6f0..c28a2dc5a 100644
--- a/man7/environ.7
+++ b/man7/environ.7
@@ -151,15 +151,14 @@ and
.PP
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.
+by average users in their day-to-day routine. Care should be taken
+to not conflict with the variables specified in the next sections.
Environment variables specific to a particular program or library function
are documented in the ENVIRONMENT section of the appropriate manual page.
-.SH ENVIRONMENT
-Common examples of environment variables are:
-.TP
-.B USER
-The name of the logged-in user (used by some BSD-derived programs).
-Set a login time, see section NOTES below.
+.SH POSIX STANDARD ENVIRONMENT
+Common examples of environment variables defined by POSIX.1-2017 are defined in the following
+section. Conforming applications shall not set these environment variables to have
+meanings other than as described.
.TP
.B LOGNAME
The name of the logged-in user (used by some System-V derived programs
@@ -170,24 +169,6 @@ Set a login time, see section NOTES below.
A user's login directory, set a login time.
Set a login time, see section NOTES below.
.TP
-.B LANG
-The name of a locale to use for locale categories when not overridden
-by
-.B LC_ALL
-or more specific environment variables such as
-.BR LC_COLLATE ,
-.BR LC_CTYPE ,
-.BR LC_MESSAGES ,
-.BR LC_MONETARY ,
-.BR LC_NUMERIC ,
-and
-.BR LC_TIME
-(see
-.BR locale (7)
-for further details of the
-.BR LC_*
-environment variables).
-.TP
.B PATH
The sequence of directory prefixes that
.BR sh (1)
@@ -246,20 +227,34 @@ command shall be valid.
.\" .B BROWSER
.\" The user's preferred utility to browse URLs. Sequence of colon-separated
.\" browser commands. See http://www.catb.org/\(tiesr/BROWSER/ .
-.PP
+.SH INTERNATIONALIZATION ENVIRONMENT VARIABLES
+.TP
+.B LANG
+The name of a locale to use for locale categories when not overridden
+by
+.B LC_ALL
+or more specific environment variables such as
+.B LC_COLLATE ,
+.B LC_CTYPE ,
+.B LC_MESSAGES ,
+.B LC_MONETARY ,
+.B LC_NUMERIC ,
+and
+.BR LC_TIME.
+See
+.BR catopen (3),
+.BR gettext (3),
+.BR locale (7)
+for further details of the
+.B LANG
+and
+.B LC_*
+environment variables.
+.SH COMMON ENVIRONMENT VARIABLES
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:
.IP * 3
-The variables
-.BR LANG ", " LANGUAGE ", " NLSPATH ", " LOCPATH ,
-.BR LC_ALL ", " LC_MESSAGES ,
-and so on influence locale handling; see
-.BR catopen (3),
-.BR gettext (3),
-and
-.BR locale (7).
-.IP *
.B TMPDIR
influences the path prefix of names created by
.BR mktemp (1),
@@ -292,6 +287,10 @@ gives the name of a file containing aliases
to be used with
.BR gethostbyname (3).
.IP *
+.B USER
+The name of the logged-in user (used by some BSD-derived programs).
+Set a login time, see section NOTES below.
+.IP *
.BR TZ " and " TZDIR
give timezone information used by
.BR tzset (3)
--
2.29.2
Reply to: