[src/trunk]: src/lib/libcurses Document LINES and COLS environment variables.

[jdc <jdc%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/f53b4dd770b4
branches:  trunk
changeset: 545426:f53b4dd770b4
user:      jdc <jdc%NetBSD.org@localhost>
date:      Tue Apr 08 18:57:09 2003 +0000

description:
Document LINES and COLS environment variables.

diffstat:

 lib/libcurses/curses_screen.3 |  24 +++++++++++++++++++-----
 1 files changed, 19 insertions(+), 5 deletions(-)

diffs (63 lines):

diff -r 7c966ca8628b -r f53b4dd770b4 lib/libcurses/curses_screen.3
--- a/lib/libcurses/curses_screen.3     Tue Apr 08 18:55:43 2003 +0000
+++ b/lib/libcurses/curses_screen.3     Tue Apr 08 18:57:09 2003 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: curses_screen.3,v 1.5 2003/02/14 16:29:12 grant Exp $
+.\"    $NetBSD: curses_screen.3,v 1.6 2003/04/08 18:57:09 jdc Exp $
 .\"
 .\" Copyright (c) 2002
 .\"    Brett Lymn (blymn%NetBSD.org@localhost, brett_lymn%yahoo.com.au@localhost)
@@ -30,7 +30,7 @@
 .\" SUCH DAMAGE.
 .\"
 .\"
-.Dd August 12, 2002
+.Dd April 8, 2003
 .Dt CURSES_SCREEN 3
 .Os
 .Sh NAME
@@ -64,6 +64,10 @@
 .Fn resizeterm "int lines" "int cols"
 .Ft int
 .Fn setterm "char *name"
+.Ft extern int
+.Dv LINES
+.Ft extern int
+.Dv COLS
 .Sh DESCRIPTION
 These functions initialize terminals and screens.
 .Pp
@@ -113,6 +117,16 @@
 .Fn newterm
 call which may be called prior to
 .Fn initscr .
+The size of the curses screen is determined by checking the
+.Xr tty 4
+size and then the
+.Xr termcap 5
+entries for the terminal type.
+If the environment variables
+.Dv LINES
+or
+.Dv COLS
+are set, then these will be used instead.
 .Pp
 The
 .Fn isendwin
@@ -153,13 +167,13 @@
 .El
 .Sh SEE ALSO
 .Xr curses_window 3 ,
+.Xr tty 4
 .Xr termcap 5
 .Sh STANDARDS
 The
-.Lb libcurses
-library complies with the X/Open Curses specification, part of the
+.Nx
+Curses library complies with the X/Open Curses specification, part of the
 Single Unix Specification.
-.Nx
 .Sh HISTORY
 The Curses package appeared in
 .Bx 4.0 .