diff options
Diffstat (limited to 'contrib/ncurses/man')
30 files changed, 579 insertions, 123 deletions
diff --git a/contrib/ncurses/man/Makefile.in b/contrib/ncurses/man/Makefile.in index a43bc25dee8b..0d7648acd7ae 100644 --- a/contrib/ncurses/man/Makefile.in +++ b/contrib/ncurses/man/Makefile.in @@ -1,6 +1,6 @@ -# $Id: Makefile.in,v 1.26 2000/04/01 22:15:22 tom Exp $ +# $Id: Makefile.in,v 1.28 2000/08/19 19:15:44 tom Exp $ ############################################################################## -# Copyright (c) 1998 Free Software Foundation, Inc. # +# Copyright (c) 1998,2000 Free Software Foundation, Inc. # # # # Permission is hereby granted, free of charge, to any person obtaining a # # copy of this software and associated documentation files (the "Software"), # @@ -36,27 +36,25 @@ SHELL = /bin/sh -INSTALL_PREFIX = @INSTALL_PREFIX@ +DESTDIR = @DESTDIR@ srcdir = @srcdir@ prefix = @prefix@ exec_prefix = @exec_prefix@ datadir = @datadir@ mandir = @mandir@ -ticdir = $(datadir)/terminfo - INSTALL = @INSTALL@ INSTALL_DATA = @INSTALL_DATA@ all \ sources: terminfo.5 -$(INSTALL_PREFIX)$(mandir) : +$(DESTDIR)$(mandir) : $(srcdir)/../mkinstalldirs $@ -EDITARGS = $(INSTALL_PREFIX)$(mandir) $(srcdir) terminfo.5 $(srcdir)/*.[0-9]* +EDITARGS = $(DESTDIR)$(mandir) $(srcdir) terminfo.5 $(srcdir)/*.[0-9]* -install install.man : terminfo.5 $(INSTALL_PREFIX)$(mandir) +install install.man : terminfo.5 $(DESTDIR)$(mandir) sh ./edit_man.sh installing $(EDITARGS) uninstall uninstall.man : diff --git a/contrib/ncurses/man/captoinfo.1m b/contrib/ncurses/man/captoinfo.1m index 16dbe805537f..40c09f5a213f 100644 --- a/contrib/ncurses/man/captoinfo.1m +++ b/contrib/ncurses/man/captoinfo.1m @@ -27,10 +27,10 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: captoinfo.1m,v 1.14 2000/03/19 02:20:28 tom Exp $ +.\" $Id: captoinfo.1m,v 1.16 2000/08/13 01:56:49 tom Exp $ .TH captoinfo 1M "" .ds n 5 -.ds d @DATADIR@/terminfo +.ds d @TERMINFO@ .SH NAME \fBcaptoinfo\fR - convert a \fItermcap\fR description into a \fIterminfo\fR description .SH SYNOPSIS @@ -178,7 +178,7 @@ You can use other \fItic\fR options such as \fB-f\fR and \fB-x\fR. The trace option isn't identical to SVr4's. Under SVr4, instead of following the -v with a trace level n, you repeat it n times. .SH SEE ALSO -\fBcurses\fR(3X), \fBinfocmp\fR(1M), \fBterminfo\fR(\*n) +\fBcurses\fR(3X), \fB@INFOCMP@\fR(1M), \fBterminfo\fR(\*n) .SH AUTHOR Eric S. Raymond <esr@snark.thyrsus.com> .\"# diff --git a/contrib/ncurses/man/clear.1 b/contrib/ncurses/man/clear.1 index 71d2883b747e..4c4991f1d1a3 100644 --- a/contrib/ncurses/man/clear.1 +++ b/contrib/ncurses/man/clear.1 @@ -1,5 +1,5 @@ .\"*************************************************************************** -.\" Copyright (c) 1998 Free Software Foundation, Inc. * +.\" Copyright (c) 1998,2000 Free Software Foundation, Inc. * .\" * .\" Permission is hereby granted, free of charge, to any person obtaining a * .\" copy of this software and associated documentation files (the * @@ -26,7 +26,7 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: clear.1,v 1.2 1998/03/11 21:12:53 juergen Exp $ +.\" $Id: clear.1,v 1.3 2000/07/15 23:59:35 china Exp $ .TH clear 1 "" .ds n 5 .SH NAME @@ -39,7 +39,7 @@ environment for the terminal type and then in the \fBterminfo\fR database to figure out how to clear the screen. .SH SEE ALSO -\fBtput\fR(1), \fBterminfo\fR(\*n) +\fB@TPUT@\fR(1), \fBterminfo\fR(\*n) .\"# .\"# The following sets edit modes for GNU EMACS .\"# Local Variables: diff --git a/contrib/ncurses/man/curs_attr.3x b/contrib/ncurses/man/curs_attr.3x index 03c8668029ca..e884fa888bb0 100644 --- a/contrib/ncurses/man/curs_attr.3x +++ b/contrib/ncurses/man/curs_attr.3x @@ -27,7 +27,7 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: curs_attr.3x,v 1.21 2000/07/01 16:50:07 tom Exp $ +.\" $Id: curs_attr.3x,v 1.22 2000/07/08 11:59:58 tom Exp $ .TH curs_attr 3X "" .SH NAME \fBattroff\fR, \fBwattroff\fR, \fBattron\fR, \fBwattron\fR, @@ -38,7 +38,8 @@ \fBattr_on\fR, \fBwattr_on\fR, \fBattr_set\fR, \fBwattr_set\fR, \fBchgat\fR, \fBwchgat\fR, -\fBmvchgat\fR, \fBmvwchgat\fR - \fBcurses\fR character and window attribute control routines +\fBmvchgat\fR, \fBmvwchgat\fR, +\fBPAIR_NUMBER\fR - \fBcurses\fR character and window attribute control routines .SH SYNOPSIS \fB#include <curses.h>\fR .br diff --git a/contrib/ncurses/man/curs_color.3x b/contrib/ncurses/man/curs_color.3x index 03cbba6349e6..ccf8cf82cfb7 100644 --- a/contrib/ncurses/man/curs_color.3x +++ b/contrib/ncurses/man/curs_color.3x @@ -1,5 +1,5 @@ .\"*************************************************************************** -.\" Copyright (c) 1998 Free Software Foundation, Inc. * +.\" Copyright (c) 1998,2000 Free Software Foundation, Inc. * .\" * .\" Permission is hereby granted, free of charge, to any person obtaining a * .\" copy of this software and associated documentation files (the * @@ -26,13 +26,17 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: curs_color.3x,v 1.10 1998/03/11 21:12:53 juergen Exp $ +.\" $Id: curs_color.3x,v 1.16 2000/07/15 22:57:03 tom Exp $ .TH curs_color 3X "" .SH NAME -\fBstart_color\fR, \fBinit_pair\fR, -\fBinit_color\fR, \fBhas_colors\fR, \fBcan_change_color\fR, -\fBcolor_content\fR, \fBpair_content\fR - \fBcurses\fR color -manipulation routines +\fBstart_color\fR, +\fBinit_pair\fR, +\fBinit_color\fR, +\fBhas_colors\fR, +\fBcan_change_color\fR, +\fBcolor_content\fR, +\fBpair_content\fR, +\fBCOLOR_PAIR\fR - \fBcurses\fR color manipulation routines .SH SYNOPSIS \fB# include <curses.h>\fR .br @@ -83,13 +87,27 @@ just turned on. The \fBinit_pair\fR routine changes the definition of a color-pair. It takes three arguments: the number of the color-pair to be changed, the foreground -color number, and the background color number. The value of the first argument -must be between \fB1\fR and \fBCOLOR_PAIRS-1\fR. The value of the second and +color number, and the background color number. +For portable applications: +.TP 5 +- +The value of the first argument +must be between \fB1\fR and \fBCOLOR_PAIRS-1\fR. +.TP 5 +- +The value of the second and third arguments must be between 0 and \fBCOLORS\fR (the 0 color pair is wired -to white on black and cannot be changed). If the color-pair was previously +to white on black and cannot be changed). +.PP +If the color-pair was previously initialized, the screen is refreshed and all occurrences of that color-pair is changed to the new definition. +As an extension, ncurses allows you to set color pair 0 via +the \fBassume_default_colors\fR routine, or to specify the use of +default colors (color number \fB-1\fR) if you first invoke the +\fBuse_default_colors\fR routine. + The \fBinit_color\fR routine changes the definition of a color. It takes four arguments: the number of the color to be changed followed by three RGB values (for the amounts of red, green, and blue components). The value of the first @@ -160,15 +178,18 @@ the background color used when parts of a window are blanked by erasing or scrolling operations, see \fBcurs_bkgd\fR(3X). Several caveats apply on 386 and 486 machines with VGA-compatible graphics: - +.TP 5 +- COLOR_YELLOW is actually brown. To get yellow, use COLOR_YELLOW combined with the \fBA_BOLD\fR attribute. - +.TP 5 +- The A_BLINK attribute should in theory cause the background to go bright. This often fails to work, and even some cards for which it mostly works (such as the Paradise and compatibles) do the wrong thing when you try to set a bright "yellow" background (you get a blinking yellow foreground instead). - +.TP 5 +- Color RGB values are not settable. .SH PORTABILITY This implementation satisfies XSI Curses's minimum maximums @@ -177,11 +198,16 @@ for \fBCOLORS\fR and \fBCOLOR_PAIRS\fR. The \fBinit_pair\fP routine accepts negative values of foreground and background color to support the \fBuse_default_colors\fP extension, but only if that routine has been first invoked. +.PP +The assumption that \fBCOLOR_BLACK\fR is the default +background color for all terminals can be modified using the +\fBassume_default_colors\fP extension, +.. .SH SEE ALSO \fBcurses\fR(3X), \fBcurs_initscr\fR(3X), \fBcurs_attr\fR(3X), -\fBdft_fgbg\fR(3X) +\fBdefault_colors\fR(3X) .\"# .\"# The following sets edit modes for GNU EMACS .\"# Local Variables: diff --git a/contrib/ncurses/man/curs_extend.3x b/contrib/ncurses/man/curs_extend.3x index 16a3f80b27aa..632fc38273d0 100644 --- a/contrib/ncurses/man/curs_extend.3x +++ b/contrib/ncurses/man/curs_extend.3x @@ -28,8 +28,8 @@ .\" .\" Author: Thomas E. Dickey <dickey@clark.net> 1999 .\" -.\" $Id: curs_extend.3x,v 1.4 2000/07/01 16:43:11 tom Exp $ -.TH use_default_colors 3X "" +.\" $Id: curs_extend.3x,v 1.6 2000/07/15 22:57:20 tom Exp $ +.TH curs_extend 3X "" .SH NAME \fBcurs_extend\fR: \fBcurses_version\fP, @@ -72,8 +72,8 @@ any code depending on them be conditioned using NCURSES_VERSION. \fBcurs_getch\fR(3X), \fBcurs_mouse\fR(3X), \fBcurs_print\fR(3X), +\fBdefault_colors\fR(3X), \fBdefine_key\fR(3X), -\fBdft_fgbg\fR(3X), \fBkeybound\fR(3X), \fBkeyok\fR(3X), \fBresizeterm\fR(3X), diff --git a/contrib/ncurses/man/curs_initscr.3x b/contrib/ncurses/man/curs_initscr.3x index 594d53fa6196..daa5e1e822de 100644 --- a/contrib/ncurses/man/curs_initscr.3x +++ b/contrib/ncurses/man/curs_initscr.3x @@ -26,7 +26,7 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: curs_initscr.3x,v 1.9 2000/07/01 19:56:51 tom Exp $ +.\" $Id: curs_initscr.3x,v 1.10 2000/07/08 12:47:39 tom Exp $ .TH curs_initscr 3X "" .SH NAME \fBinitscr\fR, @@ -42,7 +42,7 @@ .br \fBint endwin(void);\fR .br -\fBint isendwin(void);\fR +\fBbool isendwin(void);\fR .br \fBSCREEN *newterm(const char *type, FILE *outfd, FILE *infd);\fR .br diff --git a/contrib/ncurses/man/curs_mouse.3x b/contrib/ncurses/man/curs_mouse.3x index 45fdd2a38f79..316598a5594c 100644 --- a/contrib/ncurses/man/curs_mouse.3x +++ b/contrib/ncurses/man/curs_mouse.3x @@ -1,6 +1,6 @@ '\" t .\"*************************************************************************** -.\" Copyright (c) 1998,1999 Free Software Foundation, Inc. * +.\" Copyright (c) 1998,1999,2000 Free Software Foundation, Inc. * .\" * .\" Permission is hereby granted, free of charge, to any person obtaining a * .\" copy of this software and associated documentation files (the * @@ -27,12 +27,13 @@ .\" authorization. * .\"*************************************************************************** .\" -.'" $Id: curs_mouse.3x,v 1.13 1999/09/11 17:28:28 tom Exp $ +.'" $Id: curs_mouse.3x,v 1.15 2000/07/08 12:50:08 tom Exp $ .TH curs_mouse 3X "" .SH NAME \fBgetmouse\fR, \fBungetmouse\fR, \fBmousemask\fR, \fBwenclose\fR, -\fBwmouse_trafo\fR, \fBmouseinterval\fR - mouse interface through curses +\fBmouse_trafo\fR, \fBwmouse_trafo\fR, +\fBmouseinterval\fR - mouse interface through curses .SH SYNOPSIS .nf \fB#include <curses.h>\fR @@ -56,7 +57,11 @@ MEVENT;\fR .br \fBbool wenclose(WINDOW *win, int y, int x);\fR .br -\fBbool wmouse_trafo(const WINDOW* win, int* pY, int* pX, bool to_screen);\fR +\fBbool mouse_trafo(int* pY, int* pX, bool to_screen);\fR +.br +\fBbool wmouse_trafo(const WINDOW* win, int* pY, int* pX,\fR +.br + \fBbool to_screen);\fR .br \fBint mouseinterval(int erval);\fR .br diff --git a/contrib/ncurses/man/curs_pad.3x b/contrib/ncurses/man/curs_pad.3x index 35138f120336..0813a0a48f64 100644 --- a/contrib/ncurses/man/curs_pad.3x +++ b/contrib/ncurses/man/curs_pad.3x @@ -1,5 +1,5 @@ .\"*************************************************************************** -.\" Copyright (c) 1998 Free Software Foundation, Inc. * +.\" Copyright (c) 1998,2000 Free Software Foundation, Inc. * .\" * .\" Permission is hereby granted, free of charge, to any person obtaining a * .\" copy of this software and associated documentation files (the * @@ -26,12 +26,11 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: curs_pad.3x,v 1.8 1998/12/26 20:09:03 tom Exp $ +.\" $Id: curs_pad.3x,v 1.9 2000/07/04 22:38:13 tom Exp $ .TH curs_pad 3X "" .SH NAME \fBnewpad\fR, \fBsubpad\fR, \fBprefresh\fR, -\fBpnoutrefresh\fR, \fBpechochar\fR - create and display \fBcurses\fR -pads +\fBpnoutrefresh\fR, \fBpechochar\fR - create and display \fBcurses\fR pads .SH SYNOPSIS \fB#include <curses.h>\fR diff --git a/contrib/ncurses/man/curs_scanw.3x b/contrib/ncurses/man/curs_scanw.3x index c0053315c255..b7f3795d8101 100644 --- a/contrib/ncurses/man/curs_scanw.3x +++ b/contrib/ncurses/man/curs_scanw.3x @@ -26,14 +26,14 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: curs_scanw.3x,v 1.10 2000/07/01 20:06:29 tom Exp $ +.\" $Id: curs_scanw.3x,v 1.11 2000/07/15 21:48:17 tom Exp $ .TH curs_scanw 3X "" .SH NAME \fBscanw\fR, \fBwscanw\fR, \fBmvscanw\fR, \fBmvwscanw\fR, -\fBvwscanw\fR, \fBvw_scanw\fR - convert formatted input from a \fBcurses\fR widow +\fBvwscanw\fR, \fBvw_scanw\fR - convert formatted input from a \fBcurses\fR window .SH SYNOPSIS \fB#include <curses.h>\fR diff --git a/contrib/ncurses/man/curs_termattrs.3x b/contrib/ncurses/man/curs_termattrs.3x index 2ece5a3587df..3938bc0f0326 100644 --- a/contrib/ncurses/man/curs_termattrs.3x +++ b/contrib/ncurses/man/curs_termattrs.3x @@ -1,5 +1,5 @@ .\"*************************************************************************** -.\" Copyright (c) 1998 Free Software Foundation, Inc. * +.\" Copyright (c) 1998,2000 Free Software Foundation, Inc. * .\" * .\" Permission is hereby granted, free of charge, to any person obtaining a * .\" copy of this software and associated documentation files (the * @@ -26,7 +26,7 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: curs_termattrs.3x,v 1.4 1998/03/11 21:12:53 juergen Exp $ +.\" $Id: curs_termattrs.3x,v 1.6 2000/07/08 12:53:34 tom Exp $ .TH curs_termattrs 3X "" .SH NAME \fBbaudrate\fR, \fBerasechar\fR, \fBhas_ic\fR, @@ -39,9 +39,9 @@ .br \fBchar erasechar(void);\fR .br -\fBint has_ic(void);\fR +\fBbool has_ic(void);\fR .br -\fBint has_il(void);\fR +\fBbool has_il(void);\fR .br \fBchar killchar(void);\fR .br diff --git a/contrib/ncurses/man/curs_touch.3x b/contrib/ncurses/man/curs_touch.3x index 8211b06a7490..58ffa9f6042b 100644 --- a/contrib/ncurses/man/curs_touch.3x +++ b/contrib/ncurses/man/curs_touch.3x @@ -26,7 +26,7 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: curs_touch.3x,v 1.7 2000/07/01 20:08:04 tom Exp $ +.\" $Id: curs_touch.3x,v 1.8 2000/07/08 11:07:57 tom Exp $ .TH curs_touch 3X "" .SH NAME \fBtouchwin\fR, @@ -46,9 +46,9 @@ .br \fBint wtouchln(WINDOW *win, int y, int n, int changed);\fR .br -\fBint is_linetouched(WINDOW *win, int line);\fR +\fBbool is_linetouched(WINDOW *win, int line);\fR .br -\fBint is_wintouched(WINDOW *win);\fR +\fBbool is_wintouched(WINDOW *win);\fR .br .SH DESCRIPTION The \fBtouchwin\fR and \fBtouchline\fR routines throw away all diff --git a/contrib/ncurses/man/curs_trace.3x b/contrib/ncurses/man/curs_trace.3x new file mode 100644 index 000000000000..a9dc57c7c7b3 --- /dev/null +++ b/contrib/ncurses/man/curs_trace.3x @@ -0,0 +1,150 @@ +.\"*************************************************************************** +.\" Copyright (c) 2000 Free Software Foundation, Inc. * +.\" * +.\" Permission is hereby granted, free of charge, to any person obtaining a * +.\" copy of this software and associated documentation files (the * +.\" "Software"), to deal in the Software without restriction, including * +.\" without limitation the rights to use, copy, modify, merge, publish, * +.\" distribute, distribute with modifications, sublicense, and/or sell * +.\" copies of the Software, and to permit persons to whom the Software is * +.\" furnished to do so, subject to the following conditions: * +.\" * +.\" The above copyright notice and this permission notice shall be included * +.\" in all copies or substantial portions of the Software. * +.\" * +.\" THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS * +.\" OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF * +.\" MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. * +.\" IN NO EVENT SHALL THE ABOVE COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, * +.\" DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR * +.\" OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR * +.\" THE USE OR OTHER DEALINGS IN THE SOFTWARE. * +.\" * +.\" Except as contained in this notice, the name(s) of the above copyright * +.\" holders shall not be used in advertising or otherwise to promote the * +.\" sale, use or other dealings in this Software without prior written * +.\" authorization. * +.\"*************************************************************************** +.\" +.\" $Id: curs_trace.3x,v 1.3 2000/07/29 16:34:24 tom Exp $ +.TH curs_trace 3X "" +.SH NAME +\fB_tracef\fR, +\fB_tracedump\fR, +\fB_traceattr\fR, +\fB_traceattr2\fR, +\fB_nc_tracebits\fR, +\fB_tracechar\fR, +\fB_tracechtype\fR, +\fB_tracechtype2\fR, +\fB_tracemouse\fR, +\fBtrace\fR - \fBcurses\fR debugging routines +.SH SYNOPSIS +\fB#include <curses.h>\fR +.br +\fBvoid _tracef(const char *format, ...);\fR +.br +\fBvoid _tracedump(const char *label, WINDOW *win);\fR +.br +\fBchar *_traceattr(attr_t attr);\fR +.br +\fBchar *_traceattr2(int buffer, chtype ch);\fR +.br +\fBchar *_nc_tracebits(void);\fR +.br +\fBchar *_tracechar(const unsigned char ch);\fR +.br +\fBchar *_tracechtype(chtype ch);\fR +.br +\fBchar *_tracechtype2(int buffer, chtype ch);\fR +.br +\fBchar *_tracemouse(const MEVENT *event);\fR +.br +\fBvoid trace(const unsigned int param);\fR +.SH DESCRIPTION +The \fBtrace\fR routines are used for debugging the ncurses libraries, +as well as applications which use the ncurses libraries. +These functions are normally available only with the debugging library +\fIlibncurses_g.a\fR, but may be compiled into any model (shared, static, +profile) by defining the symbol \fBTRACE\fR. + +The principal parts of this interface are the \fBtrace\fR routine which +selectively enables different tracing features, and the \fB_tracef\fR +routine which writes formatted data to the \fItrace\fR file. + +Calling \fBtrace\fR with a nonzero parameter opens the file \fBtrace\fR +in the current directory for output. The parameter is formed by OR'ing +values from the list of \fBTRACE_\fP\fIxxx\fR definitions in \fB<curses.h>\fR. +These include: +.TP 5 +TRACE_DISABLE +turn off tracing. +.TP 5 +TRACE_TIMES +trace user and system times of updates. +.TP 5 +TRACE_TPUTS +trace tputs calls. +.TP 5 +TRACE_UPDATE +trace update actions, old & new screens. +.TP 5 +TRACE_MOVE +trace cursor movement and scrolling. +.TP 5 +TRACE_CHARPUT +trace all character outputs. +.TP 5 +TRACE_ORDINARY +trace all update actions. +The old and new screen contents are written to the trace file +for each refresh. +.TP 5 +TRACE_CALLS +trace all curses calls. +The parameters for each call are traced, as well as return values. +.TP 5 +TRACE_VIRTPUT +trace virtual character puts, i.e., calls to \fBaddch\fR. +.TP 5 +TRACE_IEVENT +trace low-level input processing, including timeouts. +.TP 5 +TRACE_BITS +trace state of TTY control bits. +.TP 5 +TRACE_ICALLS +trace internal/nested calls. +.TP 5 +TRACE_CCALLS +trace per-character calls. +.TP 5 +TRACE_DATABASE +trace read/write of terminfo/termcap data. +.TP 5 +TRACE_ATTRS +trace changes to video attributes and colors. +.TP 5 +TRACE_MAXIMUM +maximum trace level, enables all of the separate trace features. + +Some tracing features are enabled whenever the \fBtrace\fR parameter +is nonzero. Some features overlap. +The specific names are used as a guideline. +.. +.SH RETURN VALUE +Routines which return a value are designed to be used as parameters +to the \fB_tracef\fR routine. +.SH PORTABILITY +These functions are not part of the XSI interface. +Some other curses implementations are known to +have similar, undocumented features, +but they are not compatible with ncurses. +.SH SEE ALSO +\fBcurses\fR(3X). +.\"# +.\"# The following sets edit modes for GNU EMACS +.\"# Local Variables: +.\"# mode:nroff +.\"# fill-column:79 +.\"# End: diff --git a/contrib/ncurses/man/default_colors.3x b/contrib/ncurses/man/default_colors.3x new file mode 100644 index 000000000000..9d6d97c9e803 --- /dev/null +++ b/contrib/ncurses/man/default_colors.3x @@ -0,0 +1,133 @@ +.\"*************************************************************************** +.\" Copyright (c) 1998,1999,2000 Free Software Foundation, Inc. * +.\" * +.\" Permission is hereby granted, free of charge, to any person obtaining a * +.\" copy of this software and associated documentation files (the * +.\" "Software"), to deal in the Software without restriction, including * +.\" without limitation the rights to use, copy, modify, merge, publish, * +.\" distribute, distribute with modifications, sublicense, and/or sell * +.\" copies of the Software, and to permit persons to whom the Software is * +.\" furnished to do so, subject to the following conditions: * +.\" * +.\" The above copyright notice and this permission notice shall be included * +.\" in all copies or substantial portions of the Software. * +.\" * +.\" THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS * +.\" OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF * +.\" MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. * +.\" IN NO EVENT SHALL THE ABOVE COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, * +.\" DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR * +.\" OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR * +.\" THE USE OR OTHER DEALINGS IN THE SOFTWARE. * +.\" * +.\" Except as contained in this notice, the name(s) of the above copyright * +.\" holders shall not be used in advertising or otherwise to promote the * +.\" sale, use or other dealings in this Software without prior written * +.\" authorization. * +.\"*************************************************************************** +.\" +.\" Author: Thomas E. Dickey <dickey@clark.net> 1997,1999,2000 +.\" +.\" $Id: default_colors.3x,v 1.13 2000/07/15 22:06:50 tom Exp $ +.TH default_colors 3X "" +.SH NAME +\fBdefault_colors\fR: +\fBuse_default_colors\fR, +\fBassume_default_colors\fR \- use terminal's default colors +.. +.SH SYNOPSIS +\fB#include <curses.h>\fP + +\fBint use_default_colors(void);\fP +.br +\fBint assume_default_colors(int fg, int bg);\fP +.. +.SH DESCRIPTION +The +.I use_default_colors() +and +.I assume_default_colors() +functions are extensions to the curses library. +They are used with terminals that support ISO 6429 color, or equivalent. +These terminals allow the application to reset color to an unspecified +default value (e.g., with SGR 39 or SGR 49). +.PP +Applications that paint a colored background over the whole screen +do not take advantage of SGR 39 and SGR 49. +Some applications are designed to work with the default background, +using colors only for text. +For example, there are several implementations of the \fBls\fP program +which use colors to denote different file types or permissions. +These "color ls" programs do not necessarily modify the background color, +typically using only the \fIsetaf\fP terminfo capability to set the +foreground color. +Full-screen applications that use default colors can achieve similar +visual effects. +.PP +The first function, +.I use_default_colors() +tells the curses library to assign terminal default +foreground/background colors to color number -1. So init_pair(x,COLOR_RED,-1) +will initialize pair x as red on default background and init_pair(x,-1,COLOR_BLUE) will +initialize pair x as default foreground on blue. +.PP +The other, +.I assume_default_colors() +is a refinement which tells which colors to paint for color pair 0. +This function recognizes a special color number -1, +which denotes the default terminal color. +.PP +The following are equivalent: +.RS +.br +.I use_default_colors(); +.br +.I assume_default_colors(-1,-1); +.RE +.PP +These are ncurses extensions. +For other curses implementations, color +number -1 does not mean anything, just as for ncurses before a +successful call of \fIuse_default_colors()\fP or \fIassume_default_colors()\fP. +.PP +Other curses implementations do not allow an application to modify color pair 0. +They assume that the background is COLOR_BLACK, +but do not ensure that the color pair 0 is painted to match the +assumption. +If your application does not use either +.I use_default_colors() +or +.I assume_default_colors() +ncurses will paint a white foreground (text) with black background +for color pair 0. +.. +.SH RETURN VALUE +These functions return the integer \fBERR\fP upon failure and \fBOK\fP on success. +They will fail if either the terminal does not support +the \fIorig_pair\fP or \fIorig_colors\fP capability. +If the \fIinitialize_pair\fP capability is found, this causes an +error as well. +.. +.SH NOTES +Associated with this extension, the \fBinit_pair\fR(3X) function accepts +negative arguments to specify default foreground or background +colors. +.. +.SH PORTABILITY +These routines are specific to ncurses. They were not supported on +Version 7, BSD or System V implementations. It is recommended that +any code depending on them be conditioned using NCURSES_VERSION. +.. +.SH SEE ALSO +\fBcurs_color\fR(3X), +\fBded\fP(1). +.. +.SH AUTHOR +Thomas Dickey (from an analysis of the requirements for color xterm +for XFree86 3.1.2C, February 1996). +.\"# +.\"# The following sets edit modes for GNU EMACS +.\"# Local Variables: +.\"# mode:nroff +.\"# fill-column:79 +.\"# End: diff --git a/contrib/ncurses/man/form_fieldtype.3x b/contrib/ncurses/man/form_fieldtype.3x index 4c5dcb6616f8..d93ba281a1c8 100644 --- a/contrib/ncurses/man/form_fieldtype.3x +++ b/contrib/ncurses/man/form_fieldtype.3x @@ -1,6 +1,6 @@ '\" t .\"*************************************************************************** -.\" Copyright (c) 1998 Free Software Foundation, Inc. * +.\" Copyright (c) 1998,2000 Free Software Foundation, Inc. * .\" * .\" Permission is hereby granted, free of charge, to any person obtaining a * .\" copy of this software and associated documentation files (the * @@ -27,8 +27,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: form_fieldtype.3x,v 1.7 1998/11/29 01:07:16 Rick.Ohnemus Exp $ -.TH form_field 3X "" +.\" $Id: form_fieldtype.3x,v 1.8 2000/07/15 22:02:03 tom Exp $ +.TH form_fieldtype 3X "" .SH NAME \fBform_fieldtype\fR - define validation-field types .SH SYNOPSIS diff --git a/contrib/ncurses/man/infocmp.1m b/contrib/ncurses/man/infocmp.1m index a7449892d128..1276cca51837 100644 --- a/contrib/ncurses/man/infocmp.1m +++ b/contrib/ncurses/man/infocmp.1m @@ -27,10 +27,10 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: infocmp.1m,v 1.25 2000/06/11 02:08:16 tom Exp $ +.\" $Id: infocmp.1m,v 1.27 2000/08/19 18:51:05 tom Exp $ .TH infocmp 1M "" .ds n 5 -.ds d @DATADIR@/terminfo +.ds d @TERMINFO@ .SH NAME \fBinfocmp\fR - compare or print out \fIterminfo\fR descriptions .SH SYNOPSIS @@ -171,7 +171,7 @@ were not needed. The location of the compiled \fBterminfo\fR database is taken from the environment variable \fBTERMINFO\fR . If the variable is not defined, or the terminal is not found in that location, the system \fBterminfo\fR database, -in \fB@DATADIR@/terminfo\fR, will be used. The options \fB-A\fR +in \fB@TERMINFO@\fR, will be used. The options \fB-A\fR and \fB-B\fR may be used to override this location. The \fB-A\fR option will set \fBTERMINFO\fR for the first \fItermname\fR and the \fB-B\fR option will set \fBTERMINFO\fR for the other \fItermnames\fR. With this, it is possible to @@ -245,7 +245,7 @@ This is mainly useful for testing and analysis, since the compiled descriptions are limited (e.g., 1023 for termcap, 4096 for terminfo). .TP 5 \fB-V\fR -prints out the version of the program in use on standard error and exits. +reports the version of ncurses which was used in this program, and exits. .TP 5 \fB-e\fR Dump the capabilities of the given terminal as a C initializer for a @@ -347,6 +347,7 @@ The \fB-G\fR, \fB-R\fR, \fB-T\fR, +\fB-V\fR, \fB-a\fR, \fB-e\fR, \fB-f\fR, diff --git a/contrib/ncurses/man/infotocap.1m b/contrib/ncurses/man/infotocap.1m index 867840da0edf..ef8735b7be54 100644 --- a/contrib/ncurses/man/infotocap.1m +++ b/contrib/ncurses/man/infotocap.1m @@ -27,10 +27,10 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: infotocap.1m,v 1.2 2000/03/19 02:19:49 tom Exp $ +.\" $Id: infotocap.1m,v 1.3 2000/08/13 01:56:03 tom Exp $ .TH infotocap 1M "" .ds n 5 -.ds d @DATADIR@/terminfo +.ds d @TERMINFO@ .SH NAME \fBinfotocap\fR - convert a \fIterminfo\fR description into a \fItermcap\fR description .SH SYNOPSIS diff --git a/contrib/ncurses/man/man_db.renames b/contrib/ncurses/man/man_db.renames index fd6cbdb31d9f..b824861003c0 100644 --- a/contrib/ncurses/man/man_db.renames +++ b/contrib/ncurses/man/man_db.renames @@ -1,4 +1,4 @@ -# $Id: man_db.renames,v 0.18 2000/03/19 00:10:15 tom Exp $ +# $Id: man_db.renames,v 0.20 2000/07/15 22:58:35 tom Exp $ # Manual-page renamings for the man_db program # captoinfo.1m captoinfo.1 @@ -42,11 +42,12 @@ curs_termattrs.3x termattrs.3ncurses curs_termcap.3x termcap.3ncurses curs_terminfo.3x terminfo.3ncurses curs_touch.3x touch.3ncurses +curs_trace.3x trace.3ncurses curs_util.3x util.3ncurses curs_window.3x window.3ncurses curses.3x ncurses.3ncurses +default_colors.3x default_colors.3ncurses define_key.3x define_key.3ncurses -dft_fgbg.3x use_default_colors.3ncurses form.3x form.3form form_cursor.3x cursor.3form form_data.3x data.3form @@ -75,7 +76,7 @@ infotocap.1m infotocap.1 keybound.3x keybound.3ncurses keyok.3x keyok.3ncurses menu.3x menu.3menu -menu_attribs.3x attribs.3menu +menu_attributes.3x attributes.3menu menu_cursor.3x cursor.3menu menu_driver.3x driver.3menu menu_format.3x format.3menu diff --git a/contrib/ncurses/man/manlinks.sed b/contrib/ncurses/man/manlinks.sed index 922141955218..e175148aab9a 100644 --- a/contrib/ncurses/man/manlinks.sed +++ b/contrib/ncurses/man/manlinks.sed @@ -1,4 +1,4 @@ -# $Id: manlinks.sed,v 1.7 2000/07/01 19:50:06 tom Exp $ +# $Id: manlinks.sed,v 1.9 2000/09/30 23:32:24 tom Exp $ ############################################################################## # Copyright (c) 2000 Free Software Foundation, Inc. # # # @@ -53,11 +53,11 @@ s/\\-.*/ -/ s/ /\ /g } -:syn /^\.SH_(SYNOPSIS/,/^\.SH_(DESCRIPTION/{ /^#/d /^[^(]*$/d - s/^\([^ (]\+ [*]*\)\+//g + s/^\([^ (]* [^ (]* [*]*\)//g + s/^\([^ (]* [*]*\)//g s/\.SH_(/.SH_/ s/(.*// s/\.SH_/.SH_(/ diff --git a/contrib/ncurses/man/menu.3x b/contrib/ncurses/man/menu.3x index adbfffd92c74..8279844a39e2 100644 --- a/contrib/ncurses/man/menu.3x +++ b/contrib/ncurses/man/menu.3x @@ -1,6 +1,6 @@ '\" t .\"*************************************************************************** -.\" Copyright (c) 1998 Free Software Foundation, Inc. * +.\" Copyright (c) 1998,2000 Free Software Foundation, Inc. * .\" * .\" Permission is hereby granted, free of charge, to any person obtaining a * .\" copy of this software and associated documentation files (the * @@ -27,7 +27,7 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: menu.3x,v 1.13 1998/11/29 01:09:07 Rick.Ohnemus Exp $ +.\" $Id: menu.3x,v 1.14 2000/07/15 22:55:59 tom Exp $ .TH menu 3X "" .SH NAME \fBmenu\fR - curses extension for programming menus @@ -77,18 +77,18 @@ item_term \fBmenu_hook\fR(3X) item_userptr \fBmitem_userptr\fR(3X) item_value \fBmitem_value\fR(3X) item_visible \fBmitem_visible\fR(3X) -menu_back \fBmenu_attribs\fR(3X) +menu_back \fBmenu_attributes\fR(3X) menu_driver \fBmenu_driver\fR(3X) -menu_fore \fBmenu_attribs\fR(3X) +menu_fore \fBmenu_attributes\fR(3X) menu_format \fBmenu_format\fR(3X) -menu_grey \fBmenu_attribs\fR(3X) +menu_grey \fBmenu_attributes\fR(3X) menu_init \fBmenu_hook\fR(3X) menu_items \fBmenu_items\fR(3X) menu_mark \fBmenu_mark\fR(3X) menu_opts \fBmenu_opts\fR(3X) menu_opts_off \fBmenu_opts\fR(3X) menu_opts_on \fBmenu_opts\fR(3X) -menu_pad \fBmenu_attribs\fR(3X) +menu_pad \fBmenu_attributes\fR(3X) menu_pattern \fBmenu_pattern\fR(3X) menu_request_by_name \fBmenu_requestname\fR(3X) menu_request_name \fBmenu_requestname\fR(3X) @@ -108,15 +108,15 @@ set_item_opts \fBmitem_opts\fR(3X) set_item_term \fBmenu_hook\fR(3X) set_item_userptr \fBmitem_userptr\fR(3X) set_item_value \fBmitem_value\fR(3X) -set_menu_back \fBmenu_attribs\fR(3X) -set_menu_fore \fBmenu_attribs\fR(3X) +set_menu_back \fBmenu_attributes\fR(3X) +set_menu_fore \fBmenu_attributes\fR(3X) set_menu_format \fBmenu_format\fR(3X) -set_menu_grey \fBmenu_attribs\fR(3X) +set_menu_grey \fBmenu_attributes\fR(3X) set_menu_init \fBmenu_hook\fR(3X) set_menu_items \fBmenu_items\fR(3X) set_menu_mark \fBmenu_mark\fR(3X) set_menu_opts \fBmitem_opts\fR(3X) -set_menu_pad \fBmenu_attribs\fR(3X) +set_menu_pad \fBmenu_attributes\fR(3X) set_menu_pattern \fBmenu_pattern\fR(3X) set_menu_spacing \fBmenu_spacing\fR(3X) set_menu_sub \fBmenu_win\fR(3X) diff --git a/contrib/ncurses/man/menu_attributes.3x b/contrib/ncurses/man/menu_attributes.3x new file mode 100644 index 000000000000..82412609c9ab --- /dev/null +++ b/contrib/ncurses/man/menu_attributes.3x @@ -0,0 +1,100 @@ +'\" t +.\"*************************************************************************** +.\" Copyright (c) 1998 Free Software Foundation, Inc. * +.\" * +.\" Permission is hereby granted, free of charge, to any person obtaining a * +.\" copy of this software and associated documentation files (the * +.\" "Software"), to deal in the Software without restriction, including * +.\" without limitation the rights to use, copy, modify, merge, publish, * +.\" distribute, distribute with modifications, sublicense, and/or sell * +.\" copies of the Software, and to permit persons to whom the Software is * +.\" furnished to do so, subject to the following conditions: * +.\" * +.\" The above copyright notice and this permission notice shall be included * +.\" in all copies or substantial portions of the Software. * +.\" * +.\" THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS * +.\" OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF * +.\" MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. * +.\" IN NO EVENT SHALL THE ABOVE COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, * +.\" DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR * +.\" OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR * +.\" THE USE OR OTHER DEALINGS IN THE SOFTWARE. * +.\" * +.\" Except as contained in this notice, the name(s) of the above copyright * +.\" holders shall not be used in advertising or otherwise to promote the * +.\" sale, use or other dealings in this Software without prior written * +.\" authorization. * +.\"*************************************************************************** +.\" +.\" $Id: menu_attributes.3x,v 1.6 1998/11/29 01:09:20 Rick.Ohnemus Exp $ +.TH menu_attributes 3X "" +.SH NAME +\fBmenu_attributes\fR - color and attribute control for menus +.SH SYNOPSIS +\fB#include <menu.h>\fR +.br +int set_menu_fore(MENU *menu, chtype attr); +.br +chtype menu_fore(const MENU *menu); +.br +int set_menu_back(MENU *menu, chtype attr); +.br +chtype menu_back(const MENU *menu); +.br +int set_menu_grey(MENU *menu, chtype attr); +.br +chtype menu_grey(const MENU *menu); +.br +int set_menu_pad(MENU *menu, int pad); +.br +int menu_pad(const MENU *menu); +.br +.SH DESCRIPTION +The function \fBset_menu_fore\fR sets the foreground attribute of +\fImenu\fR. This is the highlight used for selected menu items. +\fBmenu_fore\fR returns the foreground attribute. The default +is \fBA_STANDOUT\fR. + +The function \fBset_menu_back\fR sets the background attribute of +\fImenu\fR. This is the highlight used for selectable (but not currently +selected) menu items. The function \fBmenu_back\fR returns the background +attribute. The default is \fBA_NORMAL\fR. + +The function \fBset_menu_grey\fR sets the grey attribute of \fImenu\fR. This is +the highlight used for un-selectable menu items in menus that permit more than +one selection. The function \fBmenu_grey\fR returns the grey attribute. +The default is \fBA_UNDERLINE\fR. + +The function \fBset_menu_pad\fR sets the character used to fill the space +between the name and description parts of a menu item. \fBmenu_pad\fR returns +the given menu's pad character. The default is a blank. +.SH RETURN VALUE +These routines return one of the following: +.TP 5 +\fBE_OK\fR +The routine succeeded. +.TP 5 +\fBE_SYSTEM_ERROR\fR +System error occurred (see \fBerrno\fR). +.TP 5 +\fBE_BAD_ARGUMENT\fR +Routine detected an incorrect or out-of-range argument. +.SH SEE ALSO +\fBcurses\fR(3X) and 3X pages whose names begin "menu_" for detailed +descriptions of the entry points. +.SH NOTES +The header file \fB<menu.h>\fR automatically includes the header file +\fB<curses.h>\fR. +.SH PORTABILITY +These routines emulate the System V menu library. They were not supported on +Version 7 or BSD versions. +.SH AUTHORS +Juergen Pfeifer. Manual pages and adaptation for new curses by Eric +S. Raymond. +.\"# +.\"# The following sets edit modes for GNU EMACS +.\"# Local Variables: +.\"# mode:nroff +.\"# fill-column:79 +.\"# End: diff --git a/contrib/ncurses/man/ncurses.3x b/contrib/ncurses/man/ncurses.3x index ea59af42a8df..3b36fa9a6df1 100644 --- a/contrib/ncurses/man/ncurses.3x +++ b/contrib/ncurses/man/ncurses.3x @@ -27,11 +27,11 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: ncurses.3x,v 1.39 1999/12/19 01:53:04 tom Exp $ +.\" $Id: ncurses.3x,v 1.44 2000/10/08 01:39:26 tom Exp $ .hy 0 .TH ncurses 3X "" .ds n 5 -.ds d @DATADIR@/terminfo +.ds d @TERMINFO@ .SH NAME \fBncurses\fR - CRT screen handling and optimization package .SH SYNOPSIS @@ -198,12 +198,23 @@ l l l l . \fBcurses\fR Routine Name/Manual Page Name = +COLOR_PAIR/\fBcurs_color\fR(3X) +PAIR_NUMBER/\fBcurs_attr\fR(3X) +_nc_tracebits/\fBcurs_trace\fR(3X)* +_traceattr/\fBcurs_trace\fR(3X)* +_traceattr2/\fBcurs_trace\fR(3X)* +_tracechar/\fBcurs_trace\fR(3X)* +_tracechtype/\fBcurs_trace\fR(3X)* +_tracechtype2/\fBcurs_trace\fR(3X)* +_tracedump/\fBcurs_trace\fR(3X)* +_tracef/\fBcurs_trace\fR(3X)* +_tracemouse/\fBcurs_trace\fR(3X)* addch/\fBcurs_addch\fR(3X) addchnstr/\fBcurs_addchstr\fR(3X) addchstr/\fBcurs_addchstr\fR(3X) addnstr/\fBcurs_addstr\fR(3X) addstr/\fBcurs_addstr\fR(3X) -assume_default_colors/\fBdft_fgbg\fR(3X)* +assume_default_colors/\fBdefault_colors\fR(3X)* attr_get/\fBcurs_attr\fR(3X) attr_off/\fBcurs_attr\fR(3X) attr_on/\fBcurs_attr\fR(3X) @@ -295,6 +306,7 @@ leaveok/\fBcurs_outopts\fR(3X) longname/\fBcurs_termattrs\fR(3X) mcprint/\fBcurs_print\fR(3X)* meta/\fBcurs_inopts\fR(3X) +mouse_trafo/\fBcurs_mouse\fR(3X)* mouseinterval/\fBcurs_mouse\fR(3X)* mousemask/\fBcurs_mouse\fR(3X)* move/\fBcurs_move\fR(3X) @@ -321,6 +333,7 @@ mvinsstr/\fBcurs_insstr\fR(3X) mvinstr/\fBcurs_instr\fR(3X) mvprintw/\fBcurs_printw\fR(3X) mvscanw/\fBcurs_scanw\fR(3X) +mvvline/\fBcurs_border\fR(3X) mvwaddch/\fBcurs_addch\fR(3X) mvwaddchnstr/\fBcurs_addchstr\fR(3X) mvwaddchstr/\fBcurs_addchstr\fR(3X) @@ -428,12 +441,13 @@ touchwin/\fBcurs_touch\fR(3X) tparm/\fBcurs_terminfo\fR(3X) tputs/\fBcurs_termcap\fR(3X) tputs/\fBcurs_terminfo\fR(3X) +trace/\fBcurs_trace\fR(3X)* typeahead/\fBcurs_inopts\fR(3X) unctrl/\fBcurs_util\fR(3X) ungetch/\fBcurs_getch\fR(3X) ungetmouse/\fBcurs_mouse\fR(3X)* untouchwin/\fBcurs_touch\fR(3X) -use_default_colors/\fBdft_fgbg\fR(3X)* +use_default_colors/\fBdefault_colors\fR(3X)* use_env/\fBcurs_util\fR(3X) use_extended_names/\fBcurs_extend\fR(3X)* vidattr/\fBcurs_terminfo\fR(3X) @@ -680,7 +694,7 @@ directories listed in the TERMINFO_DIRS symbol - one or more directories whose names are configured and compiled into the ncurses library, e.g., -@DATADIR@/terminfo +@TERMINFO@ .RE .TP 5 TERMINFO_DIRS @@ -695,11 +709,16 @@ the TERMPATH symbol. This is a list of filenames separated by colons (i.e., ":"). If the TERMPATH symbol is not set, \fBncurses\fR looks in the files /etc/termcap, /usr/share/misc/termcap and $HOME/.termcap, in that order. +.PP +The library may be configured to disregard the following variables when the +current user is the superuser (root), or if the application uses setuid or +setgid permissions: +$TERMINFO, $TERMINFO_DIRS, $TERMPATH, as well as $HOME. .SH FILES .TP 5 @DATADIR@/tabset directory containing initialization files for the terminal capability database -@DATADIR@/terminfo +@TERMINFO@ terminal capability database .SH SEE ALSO \fBterminfo\fR(\*n) and 3X pages whose names begin "curs_" for detailed routine diff --git a/contrib/ncurses/man/panel.3x b/contrib/ncurses/man/panel.3x index 046778a8cf96..7ebecc00ff46 100644 --- a/contrib/ncurses/man/panel.3x +++ b/contrib/ncurses/man/panel.3x @@ -26,10 +26,10 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: panel.3x,v 1.9 1998/03/11 21:12:53 juergen Exp $ +.\" $Id: panel.3x,v 1.10 2000/08/13 01:56:47 tom Exp $ .TH panel 3X "" .ds n 5 -.ds d @DATADIR@/terminfo +.ds d @TERMINFO@ .SH NAME panel - panel stack extension for curses .SH SYNOPSIS diff --git a/contrib/ncurses/man/term.5 b/contrib/ncurses/man/term.5 index f79679db608d..63a2d35f8411 100644 --- a/contrib/ncurses/man/term.5 +++ b/contrib/ncurses/man/term.5 @@ -26,10 +26,10 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: term.5,v 1.9 1998/03/11 21:12:53 juergen Exp $ +.\" $Id: term.5,v 1.10 2000/08/13 01:56:45 tom Exp $ .TH TERM 5 .ds n 5 -.ds d @DATADIR@/terminfo +.ds d @TERMINFO@ .SH NAME term \- format of compiled term file. .SH SYNOPSIS diff --git a/contrib/ncurses/man/term.7 b/contrib/ncurses/man/term.7 index e8f81bb6f0d7..5a48c5a303d3 100644 --- a/contrib/ncurses/man/term.7 +++ b/contrib/ncurses/man/term.7 @@ -26,10 +26,10 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: term.7,v 1.11 1999/01/24 02:35:14 Todd.Miller Exp $ +.\" $Id: term.7,v 1.12 2000/08/13 01:56:42 tom Exp $ .TH TERM 7 .ds n 5 -.ds d @DATADIR@/terminfo +.ds d @TERMINFO@ .SH NAME term \- conventions for naming terminal types .SH DESCRIPTION diff --git a/contrib/ncurses/man/terminfo.head b/contrib/ncurses/man/terminfo.head index 3118c1577fcf..36945ff2502b 100644 --- a/contrib/ncurses/man/terminfo.head +++ b/contrib/ncurses/man/terminfo.head @@ -26,10 +26,10 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: terminfo.head,v 1.8 1998/03/11 21:12:53 juergen Exp $ +.\" $Id: terminfo.head,v 1.9 2000/08/13 01:56:40 tom Exp $ .TH TERMINFO 5 "" "" "File Formats" .ds n 5 -.ds d @DATADIR@/terminfo +.ds d @TERMINFO@ .SH NAME terminfo \- terminal capability data base .SH SYNOPSIS diff --git a/contrib/ncurses/man/tic.1m b/contrib/ncurses/man/tic.1m index 40f790ca0f38..e3a095453d3c 100644 --- a/contrib/ncurses/man/tic.1m +++ b/contrib/ncurses/man/tic.1m @@ -26,10 +26,10 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: tic.1m,v 1.26 2000/03/19 02:18:18 tom Exp $ +.\" $Id: tic.1m,v 1.29 2000/08/19 18:51:05 tom Exp $ .TH tic 1M "" .ds n 5 -.ds d @DATADIR@/terminfo +.ds d @TERMINFO@ .SH NAME \fBtic\fR - the \fIterminfo\fR entry-description compiler .SH SYNOPSIS @@ -41,6 +41,7 @@ I\ N\ R\ T\ +V\ a\ c\ f\ @@ -147,6 +148,9 @@ eliminates size-restrictions on the generated text. This is mainly useful for testing and analysis, since the compiled descriptions are limited (e.g., 1023 for termcap, 4096 for terminfo). .TP +\fB-V\fR +reports the version of ncurses which was used in this program, and exits. +.TP \fB-r\fR Force entry resolution (so there are no remaining tc capabilities) even when doing translation to termcap format. This may be needed if you are @@ -267,6 +271,7 @@ The \fB-N\fR, \fB-R\fR, \fB-T\fR, +\fB-V\fR, \fB-a\fR, \fB-e\fR, \fB-f\fR, @@ -286,8 +291,8 @@ System V does not compile entries to or read entries from your \fB\*d/?/*\fR Compiled terminal description database. .SH SEE ALSO -\fBinfocmp\fR(1M), \fBcaptoinfo\fR(1M), \fBinfotocap\fR(1M), \fBtoe\fR(1M), -\fBcurses\fR(3X), \fBterminfo\fR(\*n). +\fB@INFOCMP@\fR(1M), \fB@CAPTOINFO@\fR(1M), \fB@INFOTOCAP@\fR(1M), +\fB@TOE@\fR(1M), \fBcurses\fR(3X), \fBterminfo\fR(\*n). .\"# .\"# The following sets edit modes for GNU EMACS .\"# Local Variables: diff --git a/contrib/ncurses/man/toe.1m b/contrib/ncurses/man/toe.1m index ea277266db1a..399cf614f3f3 100644 --- a/contrib/ncurses/man/toe.1m +++ b/contrib/ncurses/man/toe.1m @@ -1,5 +1,5 @@ .\"*************************************************************************** -.\" Copyright (c) 1998 Free Software Foundation, Inc. * +.\" Copyright (c) 1998,2000 Free Software Foundation, Inc. * .\" * .\" Permission is hereby granted, free of charge, to any person obtaining a * .\" copy of this software and associated documentation files (the * @@ -26,10 +26,10 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: toe.1m,v 1.7 1998/03/11 21:12:53 juergen Exp $ +.\" $Id: toe.1m,v 1.10 2000/08/19 18:51:05 tom Exp $ .TH toe 1M "" .ds n 5 -.ds d @DATADIR@/terminfo +.ds d @TERMINFO@ .SH NAME \fBtoe\fR - table of (terminfo) entries .SH SYNOPSIS @@ -65,14 +65,14 @@ information showing \fBtoe\fR's progress. The optional integer \fIn\fR is a number from 1 to 10, interpreted as for \fBtic\fR(1). .TP 5 \fB-V\fR -prints out the version of the program in use on standard error and exits. +reports the version of ncurses which was used in this program, and exits. .SH FILES .TP 5 \fB\*d/?/*\fR Compiled terminal description database. .SH SEE ALSO -\fBtic\fR(1M), \fBinfocmp\fR(1M), \fBcaptoinfo\fR(1M), \fBinfotocap\fR(1M), -\fBcurses\fR(3X), \fBterminfo\fR(\*n). +\fB@TIC@\fR(1M), \fB@INFOCMP@\fR(1M), \fB@CAPTOINFO@\fR(1M), +\fB@INFOTOCAP@\fR(1M), \fBcurses\fR(3X), \fBterminfo\fR(\*n). .\"# .\"# The following sets edit modes for GNU EMACS .\"# Local Variables: diff --git a/contrib/ncurses/man/tput.1 b/contrib/ncurses/man/tput.1 index 84b64b2588a1..898df1e606f5 100644 --- a/contrib/ncurses/man/tput.1 +++ b/contrib/ncurses/man/tput.1 @@ -1,6 +1,6 @@ '\" t .\"*************************************************************************** -.\" Copyright (c) 1998 Free Software Foundation, Inc. * +.\" Copyright (c) 1998,2000 Free Software Foundation, Inc. * .\" * .\" Permission is hereby granted, free of charge, to any person obtaining a * .\" copy of this software and associated documentation files (the * @@ -27,12 +27,12 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: tput.1,v 1.12 1999/01/24 02:44:26 Jeffrey.C.Honig Exp $ +.\" $Id: tput.1,v 1.16 2000/09/09 20:43:33 tom Exp $ .TH tput 1 "" -.ds d @DATADIR@/terminfo +.ds d @TERMINFO@ .ds n 5 .SH NAME -\fBtput\fR - initialize a terminal or query terminfo database +\fBtput\fR, \fBreset\fR - initialize a terminal or query terminfo database .SH SYNOPSIS \fBtput\fR [\fB-T\fR\fItype\fR] \fIcapname\fR [\fIparms\fR ... ] .br @@ -44,6 +44,8 @@ .br \fBtput -S\fR \fB<<\fR .br +\fBtput -V\fR +.br .SH DESCRIPTION The \fBtput\fR utility uses the \fBterminfo\fR database to make the values of terminal-dependent capabilities and information available to @@ -85,6 +87,9 @@ instead of from the command line (see example). Only one meaning of the \fB0\fR and \fB1\fR boolean and string exit codes (see the EXIT CODES section). .TP +\fB-V\fR +reports the version of ncurses which was used in this program, and exits. +.TP \fBinit\fR If the \fBterminfo\fR database is present and an entry for the user's terminal exists (see \fB-T\fR\fItype\fR, above), the following will @@ -110,6 +115,10 @@ user's terminal exists (see \fB-T\fR\fItype\fR 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 \fBterminfo\fR database [see \fBterm\fR(5)]. +.PP +If \fBtput\fR is invoked by a link named \fBreset\fR, this has the +same effect as \fBtput reset\fR. +See \fBtset\fR for comparison, which has similar behavior. .SH EXAMPLES .TP 5 \fBtput init\fR @@ -153,7 +162,8 @@ Send the sequence to move the cursor to row 23, column 4. Print the long name from the \fBterminfo\fR database for the type of terminal specified in the environmental variable \fBTERM\fR. -.TP 0 +.PP +.RS 5 \fBtput -S <<!\fR .br \fB> clear\fR @@ -163,6 +173,7 @@ variable \fBTERM\fR. \fB> bold\fR .br \fB> !\fR +.RE .TP 5 \& This example shows tput processing several capabilities in one @@ -187,47 +198,51 @@ sequences that set margins and tabs); for more information, see the "Tabs and Initialization" section of \fBterminfo\fR(4) .SH SEE ALSO -\fBclear\fR(1), \fBstty\fR(1), \fBtabs\fR(\*n). \fBprofile\fR(\*n), +\fB@CLEAR@\fR(1), \fBstty\fR(1), \fBtabs\fR(\*n). \fBprofile\fR(\*n), \fBterminfo\fR(4) in the \fISystem\fR \fIAdministrator\fR'\fIs\fR \fIReference\fR \fIManual\fR. Chapter 10 of the \fIProgrammer\fR'\fIs\fR \fIGuide\fR. .SH EXIT CODES If \fIcapname\fR is of type boolean, a value of \fB0\fR is set for TRUE and \fB1\fR for FALSE unless the \fB-S\fR option is used. - +.PP If \fIcapname\fR is of type string, a value of \fB0\fR is set if the \fIcapname\fR is defined for this terminal \fItype\fR (the value of \fIcapname\fR is returned on standard output); a value of \fB1\fR is set if \fIcapname\fR is not defined for this terminal \fItype\fR (a null value is returned on standard output). - +.PP If \fIcapname\fR is of type boolean or string and the \fB-S\fR option is used, a value of \fB0\fR is returned to indicate that all lines were successful. No indication of which line failed can be given so exit code \fB1\fR will never appear. Exit codes \fB2\fR, \fB3\fR, and \fB4\fR retain their usual interpretation. - +.PP If \fIcapname\fR is of type integer, a value of \fB0\fR is always set, whether or not \fIcapname\fR is defined for this terminal \fItype\fR. To determine if \fIcapname\fR is defined for this terminal \fItype\fR, the user must test the value of standard output. A value of \fB-1\fR means that \fIcapname\fR is not defined for this terminal \fItype\fR. - +.PP Any other exit code indicates an error; see the DIAGNOSTICS section. .SH DIAGNOSTICS \fBtput\fR prints the following error messages and sets the corresponding exit codes. - +.PP .TS l l. exit code error message -\fB0\fR (\fIcapname\fR is a numeric variable that is not specified in the - \fBterminfo\fR(\*n) database for this terminal type, e.g. - \fBtput -T450 lines\fR and \fBtput -T2621 xmc\fR) += +\fB0\fR T{ +(\fIcapname\fR is a numeric variable that is not specified in the +\fBterminfo\fR(\*n) database for this terminal type, e.g. +\fBtput -T450 lines\fR and \fBtput -T2621 xmc\fR) +T} \fB1\fR no error message is printed, see the \fBEXIT CODES\fR section. \fB2\fR usage error \fB3\fR unknown terminal \fItype\fR or no \fBterminfo\fR database \fB4\fR unknown \fBterminfo\fR capability \fIcapname\fR += .TE .SH PORTABILITY The \fBlongname\fR and \fB-S\fR options, and the parameter-substitution diff --git a/contrib/ncurses/man/tset.1 b/contrib/ncurses/man/tset.1 index 50d58e109574..897d9edb5446 100644 --- a/contrib/ncurses/man/tset.1 +++ b/contrib/ncurses/man/tset.1 @@ -1,5 +1,5 @@ .\"*************************************************************************** -.\" Copyright (c) 1998 Free Software Foundation, Inc. * +.\" Copyright (c) 1998,2000 Free Software Foundation, Inc. * .\" * .\" Permission is hereby granted, free of charge, to any person obtaining a * .\" copy of this software and associated documentation files (the * @@ -26,14 +26,14 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: tset.1,v 1.8 1998/12/26 01:44:41 tom Exp $ +.\" $Id: tset.1,v 1.12 2000/09/09 20:33:07 tom Exp $ .TH tset 1 "" .SH NAME -\fBtset\fR - terminal initialization +\fBtset\fR, \fBreset\fR - terminal initialization .SH SYNOPSIS -tset [-IQqrs] [-] [-e \fIch\fR] [-i \fIch\fR] [-k \fIch\fR] [-m \fImapping\fR] [\fIterminal\fR] +tset [-IQVqrs] [-] [-e \fIch\fR] [-i \fIch\fR] [-k \fIch\fR] [-m \fImapping\fR] [\fIterminal\fR] .br -reset [-IQqrs] [-] [-e \fIch\fR] [-i \fIch\fR] [-k \fIch\fR] [-m \fImapping\fR] [\fIterminal\fR] +reset [-IQVqrs] [-] [-e \fIch\fR] [-i \fIch\fR] [-k \fIch\fR] [-m \fImapping\fR] [\fIterminal\fR] .SH DESCRIPTION \&\fBTset\fR initializes terminals. \fBTset\fR first determines the type of terminal that you are using. @@ -92,6 +92,12 @@ Set the erase character to \fIch\fR. -I Do not send the terminal or tab initialization strings to the terminal. .TP 5 +-Q +Don't display any values for the erase, interrupt and line kill characters. +.TP +\fB-V\fR +reports the version of ncurses which was used in this program, and exits. +.TP 5 -i Set the interrupt character to \fIch\fR. .TP 5 @@ -102,9 +108,6 @@ Set the line kill character to \fIch\fR. Specify a mapping from a port type to a terminal. See below for more information. .TP 5 --Q -Don't display any values for the erase, interrupt and line kill characters. -.TP 5 -r Print the terminal type to the standard error output. .TP 5 @@ -228,7 +231,7 @@ environment variables. /etc/ttys system port name to terminal type mapping database (BSD versions only). .TP 5 -@DATADIR@/terminfo +@TERMINFO@ terminal capability database .SH SEE ALSO csh(1), |