X-Git-Url: http://ncurses.scripts.mit.edu/?p=ncurses.git;a=blobdiff_plain;f=doc%2Fhtml%2Fman%2Fclear.1.html;h=94ba5d55864b3411b8d9d29ddca6c0e661a6f5ba;hp=2a21936a69af82d76927112ec293071a20506b26;hb=6662c1ccb49cb09d0f2cec2ec6150410a0fd0f7f;hpb=0485620c03e69b1b58a6b12e5e45c98415fc7575 diff --git a/doc/html/man/clear.1.html b/doc/html/man/clear.1.html index 2a21936a..94ba5d55 100644 --- a/doc/html/man/clear.1.html +++ b/doc/html/man/clear.1.html @@ -1,6 +1,7 @@ - @@ -34,15 +35,15 @@ - + clear 1 - - + +

clear 1

-clear(1)                                                              clear(1)
+clear(1)                    General Commands Manual                   clear(1)
 
 
 
@@ -56,11 +57,11 @@

DESCRIPTION

-       clear  clears your screen if this is possible, including its scrollback
-       buffer (if the extended "E3" capability is defined).   clear  looks  in
-       the environment for the terminal type given by the environment variable
-       TERM, and then in the terminfo database to determine how to  clear  the
-       screen.
+       clear  clears your terminal's screen if this is possible, including the
+       terminal's scrollback  buffer  (if  the  extended  "E3"  capability  is
+       defined).   clear  looks in the environment for the terminal type given
+       by the environment variable TERM, and then in the terminfo database  to
+       determine how to clear the screen.
 
        clear  writes  to  the  standard output.  You can redirect the standard
        output to a file (which  prevents  clear  from  actually  clearing  the
@@ -70,9 +71,10 @@

OPTIONS

        -T type
-            indicates the type of terminal.  Normally this option is  unneces-
-            sary,  because  the default is taken from the environment variable
-            TERM.
+            indicates  the  type  of  terminal.   Normally  this   option   is
+            unnecessary,  because  the  default  is taken from the environment
+            variable TERM.  If -T is specified, then the shell variables LINES
+            and COLUMNS will also be ignored.
 
        -V   reports the version of ncurses which was used in this program, and
             exits.  The options are as follows:
@@ -82,20 +84,21 @@

HISTORY

-       A clear command appeared in 2.79BSD dated  February  24,  1979.   Later
+       A  clear  command  appeared  in 2.79BSD dated February 24, 1979.  Later
        that was provided in Unix 8th edition (1985).
 
-       AT&T  adapted  a  different  BSD  program  (tset) to make a new command
-       (tput), and used this to replace the clear command with a shell  script
+       AT&T adapted a different BSD program  (tset)  to  make  a  new  command
+       (tput),  and used this to replace the clear command with a shell script
        which calls tput clear, e.g.,
 
-         /usr/bin/tput ${1:+-T$1} clear 2> /dev/null
-         exit
+           /usr/bin/tput ${1:+-T$1} clear 2> /dev/null
+           exit
 
-       In 1989, when Keith Bostic revised the BSD tput command to make it sim-
-       ilar to the AT&T tput, he added a shell script for the clear command:
+       In 1989, when Keith Bostic revised the BSD  tput  command  to  make  it
+       similar  to  the  AT&T  tput,  he  added  a  shell script for the clear
+       command:
 
-         exec tput clear
+           exec tput clear
 
        The remainder of the script in each case is a copyright notice.
 
@@ -104,25 +107,25 @@
 
        The E3 extension came later:
 
-       o   In  June  1999, xterm provided an extension to the standard control
+       o   In  June  1999, xterm provided an extension to the standard control
            sequence for clearing the screen.  Rather than  clearing  just  the
            visible part of the screen using
 
-             printf '\033[2J'
+               printf '\033[2J'
 
            one could clear the scrollback using
 
-             printf '\033[3J'
+               printf '\033[3J'
 
-           This  is  documented in XTerm Control Sequences as a feature origi-
-           nating with xterm.
+           This  is  documented  in  XTerm  Control  Sequences  as  a  feature
+           originating with xterm.
 
        o   A few other terminal developers adopted the feature, e.g., PuTTY in
            2006.
 
        o   In  April  2011, a Red Hat developer submitted a patch to the Linux
            kernel, modifying its console driver to do  the  same  thing.   The
-           Linux  change,  part  of  the  3.0  release, did not mention xterm,
+           Linux  change,  part  of  the  3.0  release, did not mention xterm,
            although it was cited in the Red Hat bug report (#683733) which led
            to the change.
 
@@ -145,9 +148,9 @@

SEE ALSO

-       tput(1), terminfo(5)
+       tput(1), terminfo(5), xterm(1).
 
-       This describes ncurses version 6.0 (patch 20170819).
+       This describes ncurses version 6.3 (patch 20220724).