Hello Bastien. On 1/27/21 4:48 PM, roucaries.bast...@gmail.com wrote: > From: Bastien Roucariès <ro...@debian.org>
Again, a much better commit message is needed here, to explain what you are doing, and why. > Signed-off-by: Bastien Roucariès <ro...@debian.org> > --- > man7/environ.7 | 74 ++++++++++++++++++++++++++------------------------ > 1 file changed, 39 insertions(+), 35 deletions(-) > > diff --git a/man7/environ.7 b/man7/environ.7 > index 236025035..b461e93df 100644 > --- a/man7/environ.7 > +++ b/man7/environ.7 > @@ -82,7 +82,7 @@ command-line arguments specific to a particular use of the > program > being invoked, thus changing the program's behavior for this use case. > The environment, on the other hand, keeps track of information that is > shared by many programs and > rarely changes. For example, a running process can query the value of the > -.B TMDIR > +.B TMPDIR This is a change completely unrelated to the commit message. Also, it's actually a fix to a typo introduced in an earlier patch (08) in this series. Please don't do this sort of thing. If an earlier patch was broken, please fix that patch. > environment variable to discover a suitable location to store temporary > files. > .PP > Standard environment variables are used for information about the user' home > directory, > @@ -161,15 +161,15 @@ Common examples of environment variables defined by > POSIX.1-2017 are defined in > section. Conforming applications shall not set these environment variables > to have > meanings other than as described. > .TP > +.B HOME > +A user's login directory. > +Set at login time, see section NOTES below. > +.TP > .B LOGNAME > The name of the logged-in user (used by some System-V derived programs > and POSIX.1-2017). > Set at login time, see section NOTES below. > .TP > -.B HOME > -A user's login directory. > -Set at login time, see section NOTES below. > -.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 > @@ -204,26 +204,16 @@ Set at login time, see section NOTES below. > .B TERM > The terminal type for which output is to be prepared. > .TP > -.B PAGER > -The user's preferred utility to display text files. > -Any string acceptable as a command_string operand to the > -.I sh\ \-c > -command shall be valid. If the > -.B PAGER > -variable is null or not set, > -command could fall back > -.B more (1) > -or any suitable paging utility as the system default. > -.TP > -.BR EDITOR / VISUAL > -The user's preferred utility to edit text files. > -Any string acceptable as a command_string operand to the > -.I sh\ \-c > -command shall be valid. > -.\" .TP > -.\" .B BROWSER > -.\" The user's preferred utility to browse URLs. Sequence of colon-separated > -.\" browser commands. See http://www.catb.org/\(tiesr/BROWSER/ . > +.B TMPDIR > +The current temporary directory. > +Influences the path prefix of names created by > +.BR mktemp (1), > +.BR mkstemp (3), > +.BR mkdtemp (3), TMPDIR does not influence the above three, as far as I know. See my comments in patch 01. > +.BR tmpfile (3), > +and other routines, and the temporary directory used by > +.BR sort (1) > +and other programs. > .SH INTERNATIONALIZATION ENVIRONMENT VARIABLES > .TP > .B LANG > @@ -247,21 +237,35 @@ for further details of the > and > .B LC_* > environment variables. > +.SH USER CUSTOMIZATION ENVIRONMENT VARIABLES > +The following variables are commonly used for personalizing > +applications used by the user. > +.TP > +.B PAGER > +The user's preferred utility to display text files. > +Any string acceptable as a command_string operand to the > +.I sh\ \-c > +command shall be valid. If the > +.B PAGER > +variable is null or not set, > +command could fall back > +.B more (1) > +or any suitable paging utility as the system default. > +.TP > +.BR EDITOR / VISUAL > +The user's preferred utility to edit text files. > +Any string acceptable as a command_string operand to the > +.I sh\ \-c > +command shall be valid. Defined by POSIX.1-2017. > +.\" .TP > +.\" .B BROWSER > +.\" The user's preferred utility to browse URLs. Sequence of colon-separated > +.\" browser commands. See http://www.catb.org/\(tiesr/BROWSER/ . > .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 > -.B TMPDIR > -influences the path prefix of names created by > -.BR mktemp (1), > -.BR mkstemp (3), > -.BR mkdtemp (3), > -.BR tmpfile (3), > -and other routines, and the temporary directory used by > -.BR sort (1) > -and other programs. > -.IP * > .BR LD_LIBRARY_PATH ", " LD_PRELOAD , > and other > .BR LD_* Thanks, Michael -- Michael Kerrisk Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/ Linux/UNIX System Programming Training: http://man7.org/training/
