[PATCH 13/14] Document LINES and COLUMNS

[roucaries.bastien@gmail.com]

From: Bastien Roucariès <rouca@debian.org>

Document the variable LINES and COLUMN

Signed-off-by: Bastien Roucariès <rouca@debian.org>
---
 man7/environ.7 | 45 ++++++++++++++++++++++++++++++++++++++++++---
 1 file changed, 42 insertions(+), 3 deletions(-)

diff --git a/man7/environ.7 b/man7/environ.7
index ebf738a15..79f34a302 100644
--- a/man7/environ.7
+++ b/man7/environ.7
@@ -244,6 +244,48 @@ environment variables.
 The following variables are commonly used for personalizing
 the applications used by user.
 .TP
+.B COLUMNS
+This variable is a positive or zero decimal integer used to indicate the user's preferred width
+in column positions for the terminal screen or window.
+If this variable is unset or set to zero, the applications determines
+the number of columns, appropriate for the terminal or window.
+When
+.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, application 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 positive or zero decimal integer used to indicate the user's preferred number
+of lines for the terminal screen or window.
+If this variable is unset or set to zero, the applications determines
+the number of lines, appropriate for the terminal or window.
+When
+.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, application 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
@@ -311,9 +353,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