Bug#981171: [PATCH 13/13] Document LINES and COLUMNS
Hi, Le jeu. 28 janv. 2021 à 08:53, Michael Kerrisk (man-pages) a écrit : > > Hello Bastiern, > > On 1/27/21 4:48 PM, roucaries.bast...@gmail.com wrote: > > From: Bastien Roucariès > > > > Document the variable LINES and COLUMN > > > > Signed-off-by: Bastien Roucariès > > --- > > man7/environ.7 | 45 ++--- > > 1 file changed, 42 insertions(+), 3 deletions(-) > > > > diff --git a/man7/environ.7 b/man7/environ.7 > > index b461e93df..5665ac4d2 100644 > > --- a/man7/environ.7 > > +++ b/man7/environ.7 > > @@ -241,6 +241,48 @@ environment variables. > > The following variables are commonly used for personalizing > > applications used by the user. > > .TP > > +.B COLUMNS > > The following text is copied almost word for word from the standard. > For copyright reasons, we can't do that. > > > +This variable is a non-negative decimal integer used to indicate the > > user's preferred width > > +in column positions for the terminal screen or window. > > +If this variable is unset, set to zero, or empty, applications will > > How did you determine the bit about 'set to zero'? That's > not mentioned in the standard? Ok that was a research on sources.debian.org. I will mention on notes Bastien > > Similar comments to the above, for LINES, below. > > Thanks, > > Michael > > > > +determine the appropriate value themselves. > > +When the > > +.B COLUMNS > > +environment variable > > +is set, any terminal-width information implied by the > > +.B TERM > > +environment variable is overridden. > > +.IP > > +Users and applications should not set > > +.B COLUMNS > > +unless they wish to override the system selection. > > +In this case, applications may produce output unrelated to the terminal > > characteristics. > > +Users should not need to set this variable in the environment unless > > +there is a specific reason to override the implementation's default > > behavior, > > +such as to display data in an area arbitrarily smaller than the terminal > > or window. > > +.TP > > +.B LINES > > +This variable is a non-negative decimal integer used to indicate the > > user's preferred > > +number of lines for the terminal screen or window. > > +If this variable is unset, set to zero, or empty, applications will > > +determine the appropriate value themselves. > > +When the > > +.B LINES > > +environment variable > > +is set, any terminal-width information implied by the > > +.B TERM > > +environment variable is overridden. > > +.IP > > +As for the related variable > > +.B COLUMNS, > > +users and applications should not set > > +.B LINES > > +unless they wish to override the system selection. > > +In this case, applications may produce output unrelated to the terminal > > characteristics. > > +Users should not need to set this variable in the environment unless > > +there is a specific reason to override the implementation's default > > behavior, > > +such as to display data in an area arbitrarily smaller than the terminal > > or window. > > +.TP > > .B PAGER > > The user's preferred utility to display text files. > > Any string acceptable as a command_string operand to the > > @@ -307,9 +349,6 @@ See also > > gives information on how to address a given terminal > > (or gives the name of a file containing such information). > > .IP * > > -.BR COLUMNS " and " LINES > > -tell applications about the window size, possibly overriding the actual > > size. > > -.IP * > > .BR PRINTER " or " LPDEST > > may specify the desired printer to use. > > See > > > > > -- > Michael Kerrisk > Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/ > Linux/UNIX System Programming Training: http://man7.org/training/
Bug#981171: [PATCH 13/13] Document LINES and COLUMNS
Hello Bastiern, On 1/27/21 4:48 PM, roucaries.bast...@gmail.com wrote: > From: Bastien Roucariès > > Document the variable LINES and COLUMN > > Signed-off-by: Bastien Roucariès > --- > man7/environ.7 | 45 ++--- > 1 file changed, 42 insertions(+), 3 deletions(-) > > diff --git a/man7/environ.7 b/man7/environ.7 > index b461e93df..5665ac4d2 100644 > --- a/man7/environ.7 > +++ b/man7/environ.7 > @@ -241,6 +241,48 @@ environment variables. > The following variables are commonly used for personalizing > applications used by the user. > .TP > +.B COLUMNS The following text is copied almost word for word from the standard. For copyright reasons, we can't do that. > +This variable is a non-negative decimal integer used to indicate the user's > preferred width > +in column positions for the terminal screen or window. > +If this variable is unset, set to zero, or empty, applications will How did you determine the bit about 'set to zero'? That's not mentioned in the standard? Similar comments to the above, for LINES, below. Thanks, Michael > +determine the appropriate value themselves. > +When the > +.B COLUMNS > +environment variable > +is set, any terminal-width information implied by the > +.B TERM > +environment variable is overridden. > +.IP > +Users and applications should not set > +.B COLUMNS > +unless they wish to override the system selection. > +In this case, applications may produce output unrelated to the terminal > characteristics. > +Users should not need to set this variable in the environment unless > +there is a specific reason to override the implementation's default behavior, > +such as to display data in an area arbitrarily smaller than the terminal or > window. > +.TP > +.B LINES > +This variable is a non-negative decimal integer used to indicate the user's > preferred > +number of lines for the terminal screen or window. > +If this variable is unset, set to zero, or empty, applications will > +determine the appropriate value themselves. > +When the > +.B LINES > +environment variable > +is set, any terminal-width information implied by the > +.B TERM > +environment variable is overridden. > +.IP > +As for the related variable > +.B COLUMNS, > +users and applications should not set > +.B LINES > +unless they wish to override the system selection. > +In this case, applications may produce output unrelated to the terminal > characteristics. > +Users should not need to set this variable in the environment unless > +there is a specific reason to override the implementation's default behavior, > +such as to display data in an area arbitrarily smaller than the terminal or > window. > +.TP > .B PAGER > The user's preferred utility to display text files. > Any string acceptable as a command_string operand to the > @@ -307,9 +349,6 @@ See also > gives information on how to address a given terminal > (or gives the name of a file containing such information). > .IP * > -.BR COLUMNS " and " LINES > -tell applications about the window size, possibly overriding the actual size. > -.IP * > .BR PRINTER " or " LPDEST > may specify the desired printer to use. > See > -- Michael Kerrisk Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/ Linux/UNIX System Programming Training: http://man7.org/training/
Bug#981171: [PATCH 13/13] Document LINES and COLUMNS
From: Bastien Roucariès Document the variable LINES and COLUMN Signed-off-by: Bastien Roucariès --- man7/environ.7 | 45 ++--- 1 file changed, 42 insertions(+), 3 deletions(-) diff --git a/man7/environ.7 b/man7/environ.7 index b461e93df..5665ac4d2 100644 --- a/man7/environ.7 +++ b/man7/environ.7 @@ -241,6 +241,48 @@ environment variables. The following variables are commonly used for personalizing applications used by the user. .TP +.B COLUMNS +This variable is a non-negative decimal integer used to indicate the user's preferred width +in column positions for the terminal screen or window. +If this variable is unset, set to zero, or empty, applications will +determine the appropriate value themselves. +When the +.B COLUMNS +environment variable +is set, any terminal-width information implied by the +.B TERM +environment variable is overridden. +.IP +Users and applications should not set +.B COLUMNS +unless they wish to override the system selection. +In this case, applications may produce output unrelated to the terminal characteristics. +Users should not need to set this variable in the environment unless +there is a specific reason to override the implementation's default behavior, +such as to display data in an area arbitrarily smaller than the terminal or window. +.TP +.B LINES +This variable is a non-negative decimal integer used to indicate the user's preferred +number of lines for the terminal screen or window. +If this variable is unset, set to zero, or empty, applications will +determine the appropriate value themselves. +When the +.B LINES +environment variable +is set, any terminal-width information implied by the +.B TERM +environment variable is overridden. +.IP +As for the related variable +.B COLUMNS, +users and applications should not set +.B LINES +unless they wish to override the system selection. +In this case, applications may produce output unrelated to the terminal characteristics. +Users should not need to set this variable in the environment unless +there is a specific reason to override the implementation's default behavior, +such as to display data in an area arbitrarily smaller than the terminal or window. +.TP .B PAGER The user's preferred utility to display text files. Any string acceptable as a command_string operand to the @@ -307,9 +349,6 @@ See also gives information on how to address a given terminal (or gives the name of a file containing such information). .IP * -.BR COLUMNS " and " LINES -tell applications about the window size, possibly overriding the actual size. -.IP * .BR PRINTER " or " LPDEST may specify the desired printer to use. See -- 2.29.2
