From: Bastien Roucariès <[email protected]> Introduce a Posix defined environment, other and internalization
Signed-off-by: Bastien Roucariès <[email protected]> --- man7/environ.7 | 69 +++++++++++++++++++++++++------------------------- 1 file changed, 34 insertions(+), 35 deletions(-) diff --git a/man7/environ.7 b/man7/environ.7 index 96d47be9f..236025035 100644 --- a/man7/environ.7 +++ b/man7/environ.7 @@ -152,15 +152,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 at 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 @@ -171,24 +170,6 @@ Set at login time, see section NOTES below. A user's login directory. Set at 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 list of places that shells and other programs look in to find a command when given an incomplete pathname. Elements on this @@ -243,20 +224,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), @@ -289,6 +284,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 at login time, see section NOTES below. +.IP * .BR TZ " and " TZDIR give timezone information used by .BR tzset (3) -- 2.29.2
