Hello Bastiern,

On 1/27/21 4:48 PM, roucaries.bast...@gmail.com wrote:
> 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

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/

Reply via email to