From: Bastien Roucariès <ro...@debian.org> Document the variable LINES and COLUMN
Signed-off-by: Bastien Roucariès <ro...@debian.org> --- 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