diff options
Diffstat (limited to 'ncurses-5.2/doc/html/man/tput.1.html')
-rw-r--r-- | ncurses-5.2/doc/html/man/tput.1.html | 246 |
1 files changed, 246 insertions, 0 deletions
diff --git a/ncurses-5.2/doc/html/man/tput.1.html b/ncurses-5.2/doc/html/man/tput.1.html new file mode 100644 index 0000000..17c55aa --- /dev/null +++ b/ncurses-5.2/doc/html/man/tput.1.html @@ -0,0 +1,246 @@ +<HTML> +<BODY> +<PRE> +<!-- Manpage converted by man2html 3.0.1 --> + +</PRE> +<H2>NAME</H2><PRE> + <B>tput</B>, <B>reset</B> - initialize a terminal or query terminfo + database + + +</PRE> +<H2>SYNOPSIS</H2><PRE> + <B>tput</B> [<B>-T</B><I>type</I>] <I>capname</I> [<I>parms</I> ... ] + <B>tput</B> [<B>-T</B><I>type</I>] <B>init</B> + <B>tput</B> [<B>-T</B><I>type</I>] <B>reset</B> + <B>tput</B> [<B>-T</B><I>type</I>] <B>longname</B> + <B>tput</B> <B>-S</B> <B><<</B> + <B>tput</B> <B>-V</B> + + +</PRE> +<H2>DESCRIPTION</H2><PRE> + The <B>tput</B> utility uses the <B>terminfo</B> database to make the + values of terminal-dependent capabilities and information + available to the shell (see <B><A HREF="sh.1.html">sh(1)</A></B>), to initialize or reset + the terminal, or return the long name of the requested + terminal type. <B>tput</B> outputs a string if the attribute + (<I>cap</I>ability <I>name</I>) is of type string, or an integer if the + attribute is of type integer. If the attribute is of type + boolean, <B>tput</B> simply sets the exit code (<B>0</B> for TRUE if the + terminal has the capability, <B>1</B> for FALSE if it does not), + and produces no output. Before using a value returned on + standard output, the user should test the exit code [<B>$?</B>, + see <B><A HREF="sh.1.html">sh(1)</A></B>] to be sure it is <B>0</B>. (See the <B>EXIT</B> <B>CODES</B> and + <B>DIAGNOSTICS</B> sections.) For a complete list of capabili- + ties and the <I>capname</I> associated with each, see <B>ter-</B> + <B><A HREF="minfo.5.html">minfo(5)</A></B>. + + <B>-T</B><I>type</I> indicates the <I>type</I> of terminal. Normally this + option is unnecessary, because the default is taken + from the environment variable <B>TERM</B>. If <B>-T</B> is spec- + ified, then the shell variables <B>LINES</B> and <B>COLUMNS</B> + will be ignored,and the operating system will not + be queried for the actual screen size. + + <I>capname</I> + indicates the attribute from the <B>terminfo</B> database. + When <B>termcap</B> support is compiled in, the <B>termcap</B> + name for the attribute is also accepted. + + <I>parms</I> If the attribute is a string that takes parameters, + the arguments <I>parms</I> will be instantiated into the + string. An all numeric argument will be passed to + the attribute as a number. + + <B>-S</B> allows more than one capability per invocation of + <B>tput</B>. The capabilities must be passed to <B>tput</B> from + the standard input instead of from the command line + (see example). Only one <I>capname</I> is allowed per + line. The <B>-S</B> option changes the meaning of the <B>0</B> + and <B>1</B> boolean and string exit codes (see the EXIT + CODES section). + + <B>-V</B> reports the version of ncurses which was used in + this program, and exits. + + <B>init</B> If the <B>terminfo</B> database is present and an entry + for the user's terminal exists (see <B>-T</B><I>type</I>, above), + the following will occur: (1) if present, the ter- + minal's initialization strings will be output (<B>is1</B>, + <B>is2</B>, <B>is3</B>, <B>if</B>, <B>iprog</B>), (2) any delays (e.g., new- + line) specified in the entry will be set in the tty + driver, (3) tabs expansion will be turned on or off + according to the specification in the entry, and + (4) if tabs are not expanded, standard tabs will be + set (every 8 spaces). If an entry does not contain + the information needed for any of the four above + activities, that activity will silently be skipped. + + <B>reset</B> Instead of putting out initialization strings, the + terminal's reset strings will be output if present + (<B>rs1</B>, <B>rs2</B>, <B>rs3</B>, <B>rf</B>). If the reset strings are not + present, but initialization strings are, the ini- + tialization strings will be output. Otherwise, + <B>reset</B> acts identically to <B>init</B>. + + <B>longname</B> + If the <B>terminfo</B> database is present and an entry + for the user's terminal exists (see <B>-T</B><I>type</I> above), + then the long name of the terminal will be put out. + The long name is the last name in the first line of + the terminal's description in the <B>terminfo</B> database + [see <B><A HREF="term.5.html">term(5)</A></B>]. + + If <B>tput</B> is invoked by a link named <B>reset</B>, this has the + same effect as <B>tput</B> <B>reset</B>. See <B>tset</B> for comparison, which + has similar behavior. + + +</PRE> +<H2>EXAMPLES</H2><PRE> + <B>tput</B> <B>init</B> + Initialize the terminal according to the type of ter- + minal in the environmental variable <B>TERM</B>. This com- + mand should be included in everyone's .profile after + the environmental variable <B>TERM</B> has been exported, as + illustrated on the <B><A HREF="profile.4.html">profile(4)</A></B> manual page. + + <B>tput</B> <B>-T5620</B> <B>reset</B> + Reset an AT&T 5620 terminal, overriding the type of + terminal in the environmental variable <B>TERM</B>. + + <B>tput</B> <B>cup</B> <B>0</B> <B>0</B> + Send the sequence to move the cursor to row <B>0</B>, column + <B>0</B> (the upper left corner of the screen, usually known + as the "home" cursor position). + + <B>tput</B> <B>clear</B> + Echo the clear-screen sequence for the current + terminal. + + <B>tput</B> <B>cols</B> + Print the number of columns for the current terminal. + + <B>tput</B> <B>-T450</B> <B>cols</B> + Print the number of columns for the 450 terminal. + + <B>bold=`tput</B> <B>smso`</B> <B>offbold=`tput</B> <B>rmso`</B> + Set the shell variables <B>bold</B>, to begin stand-out mode + sequence, and <B>offbold</B>, to end standout mode sequence, + for the current terminal. This might be followed by + a prompt: <B>echo</B> <B>"${bold}Please</B> <B>type</B> <B>in</B> <B>your</B> <B>name:</B> + <B>${offbold}\c"</B> + + <B>tput</B> <B>hc</B> + Set exit code to indicate if the current terminal is + a hard copy terminal. + + <B>tput</B> <B>cup</B> <B>23</B> <B>4</B> + Send the sequence to move the cursor to row 23, col- + umn 4. + + <B>tput</B> <B>longname</B> + Print the long name from the <B>terminfo</B> database for + the type of terminal specified in the environmental + variable <B>TERM</B>. + + <B>tput</B> <B>-S</B> <B><<!</B> + <B>></B> <B>clear</B> + <B>></B> <B>cup</B> <B>10</B> <B>10</B> + <B>></B> <B>bold</B> + <B>></B> <B>!</B> + + This example shows tput processing several capabili- + ties in one invocation. This example clears the + screen, moves the cursor to position 10, 10 and turns + on bold (extra bright) mode. The list is terminated + by an exclamation mark (<B>!</B>) on a line by itself. + + +</PRE> +<H2>FILES</H2><PRE> + <B>/usr/share/terminfo</B> + compiled terminal description database + + <B>/usr/include/curses.h</B> + <B><A HREF="ncurses.3x.html">curses(3x)</A></B> header file + + <B>/usr/include/term.h</B> + <B>terminfo</B> header file + + <B>/usr/share/tabset/*</B> + tab settings for some terminals, in a format appro- + priate to be output to the terminal (escape + sequences that set margins and tabs); for more + information, see the "Tabs and Initialization" sec- + tion of <B><A HREF="terminfo.4.html">terminfo(4)</A></B> + + +</PRE> +<H2>SEE ALSO</H2><PRE> + <B><A HREF="clear.1.html">clear(1)</A></B>, <B><A HREF="stty.1.html">stty(1)</A></B>, <B><A HREF="tabs.5.html">tabs(5)</A></B>. <B><A HREF="profile.5.html">profile(5)</A></B>, <B><A HREF="terminfo.4.html">terminfo(4)</A></B> in + the <I>System</I> <I>Administrator</I>'<I>s</I> <I>Reference</I> <I>Manual</I>. Chapter 10 + of the <I>Programmer</I>'<I>s</I> <I>Guide</I>. + + +</PRE> +<H2>EXIT CODES</H2><PRE> + If <I>capname</I> is of type boolean, a value of <B>0</B> is set for + TRUE and <B>1</B> for FALSE unless the <B>-S</B> option is used. + + If <I>capname</I> is of type string, a value of <B>0</B> is set if the + <I>capname</I> is defined for this terminal <I>type</I> (the value of + <I>capname</I> is returned on standard output); a value of <B>1</B> is + set if <I>capname</I> is not defined for this terminal <I>type</I> (a + null value is returned on standard output). + + If <I>capname</I> is of type boolean or string and the <B>-S</B> option + is used, a value of <B>0</B> is returned to indicate that all + lines were successful. No indication of which line failed + can be given so exit code <B>1</B> will never appear. Exit codes + <B>2</B>, <B>3</B>, and <B>4</B> retain their usual interpretation. + + If <I>capname</I> is of type integer, a value of <B>0</B> is always set, + whether or not <I>capname</I> is defined for this terminal <I>type</I>. + To determine if <I>capname</I> is defined for this terminal <I>type</I>, + the user must test the value of standard output. A value + of <B>-1</B> means that <I>capname</I> is not defined for this terminal + <I>type</I>. + + Any other exit code indicates an error; see the DIAGNOS- + TICS section. + + +</PRE> +<H2>DIAGNOSTICS</H2><PRE> + <B>tput</B> prints the following error messages and sets the cor- + responding exit codes. + + exit code error message + --------------------------------------------------------------------- + <B>0</B> (<I>capname</I> is a numeric variable that is not specified in + the <B><A HREF="terminfo.5.html">terminfo(5)</A></B> database for this terminal type, e.g. + <B>tput</B> <B>-T450</B> <B>lines</B> and <B>tput</B> <B>-T2621</B> <B>xmc</B>) + <B>1</B> no error message is printed, see the <B>EXIT</B> <B>CODES</B> section. + <B>2</B> usage error + <B>3</B> unknown terminal <I>type</I> or no <B>terminfo</B> database + <B>4</B> unknown <B>terminfo</B> capability <I>capname</I> + --------------------------------------------------------------------- + + +</PRE> +<H2>PORTABILITY</H2><PRE> + The <B>longname</B> and <B>-S</B> options, and the parameter-substitu- + tion features used in the <B>cup</B> example, are not supported + in BSD curses or in AT&T/USL curses before SVr4. + +</PRE> +<HR> +<ADDRESS> +Man(1) output converted with +<a href="http://www.oac.uci.edu/indiv/ehood/man2html.html">man2html</a> +</ADDRESS> +</BODY> +</HTML> |