diff options
Diffstat (limited to 'upstream/mageia-cauldron/man3')
129 files changed, 1907 insertions, 1122 deletions
diff --git a/upstream/mageia-cauldron/man3/curs_add_wch.3x b/upstream/mageia-cauldron/man3/curs_add_wch.3x index 70d849f1..a239b2a6 100644 --- a/upstream/mageia-cauldron/man3/curs_add_wch.3x +++ b/upstream/mageia-cauldron/man3/curs_add_wch.3x @@ -28,8 +28,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: curs_add_wch.3x,v 1.53 2024/01/13 22:05:39 tom Exp $ -.TH curs_add_wch 3X 2024-01-13 "ncurses 6.4" "Library calls" +.\" $Id: curs_add_wch.3x,v 1.57 2024/03/23 19:58:15 tom Exp $ +.TH curs_add_wch 3X 2024-03-23 "ncurses 6.4" "Library calls" .ie \n(.g \{\ .ds `` \(lq .ds '' \(rq @@ -293,7 +293,7 @@ U+2550 BOX DRAWINGS DOUBLE HORIZONTAL .SH RETURN VALUE All routines return the integer \fBERR\fP upon failure and \fBOK\fP on success. .PP -X/Open does not define any error conditions. +X/Open Curses does not specify any error conditions. This implementation returns an error .bP if the window pointer is null or @@ -338,7 +338,7 @@ wide characters. The misdefined symbols are the arrows and other symbols which are not used for line-drawing. .PP -X/Open Curses does not define symbols for thick- or double-lines. +X/Open Curses does not specify symbols for thick- or double-lines. SVr4 curses implementations defined their line-drawing symbols in terms of intermediate symbols. This implementation extends those symbols, providing new definitions @@ -423,12 +423,22 @@ may hold one non-spacing character. In the latter case, \fI\%ncurses\fP adds the non-spacing character to the active (base) spacing character. +.SS TABSIZE +The +.B TABSIZE +variable is implemented in SVr4 and other versions of +.IR curses , +but is not specified by X/Open Curses +(see \fBcurs_variables\fP(3X)). .SH SEE ALSO \fB\%curses\fP(3X), \fB\%curs_addch\fP(3X), +\fB\%curs_addwstr\fP(3X), +\fB\%curs_add_wchstr\fP(3X), \fB\%curs_attr\fP(3X), \fB\%curs_clear\fP(3X), \fB\%curs_getcchar\fP(3X), \fB\%curs_outopts\fP(3X), \fB\%curs_refresh\fP(3X), +\fB\%curs_variables\fP(3X), \fB\%putwc\fP(3) diff --git a/upstream/mageia-cauldron/man3/curs_add_wchstr.3x b/upstream/mageia-cauldron/man3/curs_add_wchstr.3x index c53b812c..ee4288e7 100644 --- a/upstream/mageia-cauldron/man3/curs_add_wchstr.3x +++ b/upstream/mageia-cauldron/man3/curs_add_wchstr.3x @@ -1,5 +1,5 @@ .\"*************************************************************************** -.\" Copyright 2019-2022,2023 Thomas E. Dickey * +.\" Copyright 2019-2023,2024 Thomas E. Dickey * .\" Copyright 2002-2012,2017 Free Software Foundation, Inc. * .\" * .\" Permission is hereby granted, free of charge, to any person obtaining a * @@ -27,8 +27,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: curs_add_wchstr.3x,v 1.32 2023/11/25 14:01:49 tom Exp $ -.TH curs_add_wchstr 3X 2023-11-25 "ncurses 6.4" "Library calls" +.\" $Id: curs_add_wchstr.3x,v 1.34 2024/03/16 19:44:53 tom Exp $ +.TH curs_add_wchstr 3X 2024-03-16 "ncurses 6.4" "Library calls" .ie \n(.g \{\ .ds `` \(lq .ds '' \(rq @@ -102,7 +102,7 @@ the remaining columns are filled with the background character and rendition. .SH RETURN VALUE All functions return the integer \fBERR\fP upon failure and \fBOK\fP on success. .PP -X/Open does not define any error conditions. +X/Open Curses does not specify any error conditions. This implementation returns an error .bP if the \fIwin\fP parameter is null or diff --git a/upstream/mageia-cauldron/man3/curs_addch.3x b/upstream/mageia-cauldron/man3/curs_addch.3x index b87f7663..38ef7a35 100644 --- a/upstream/mageia-cauldron/man3/curs_addch.3x +++ b/upstream/mageia-cauldron/man3/curs_addch.3x @@ -1,6 +1,6 @@ '\" t .\"*************************************************************************** -.\" Copyright 2018-2022,2023 Thomas E. Dickey * +.\" Copyright 2018-2023,2024 Thomas E. Dickey * .\" Copyright 1998-2015,2017 Free Software Foundation, Inc. * .\" * .\" Permission is hereby granted, free of charge, to any person obtaining a * @@ -28,17 +28,23 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: curs_addch.3x,v 1.76 2023/12/23 16:27:51 tom Exp $ -.TH curs_addch 3X 2023-12-23 "ncurses 6.4" "Library calls" +.\" $Id: curs_addch.3x,v 1.81 2024/03/23 20:38:57 tom Exp $ +.TH curs_addch 3X 2024-03-23 "ncurses 6.4" "Library calls" .ie \n(.g \{\ .ds `` \(lq .ds '' \(rq +.ds ' \(aq +.ds ^ \(ha +.ds ~ \(ti .\} .el \{\ .ie t .ds `` `` .el .ds `` "" .ie t .ds '' '' .el .ds '' "" +.ds ' ' +.ds ^ ^ +.ds ~ ~ .\} . .de bP @@ -67,94 +73,149 @@ add a \fIcurses\fR character to a window and advance the cursor .fi .SH DESCRIPTION .SS "Adding Characters" -The \fBaddch\fP, \fBwaddch\fP, \fBmvaddch\fP and \fBmvwaddch\fP routines put -the character \fIch\fP into the given window at its current window position, -which is then advanced. -They are analogous to the standard C library's \fI\%putchar\fP(3). -If the advance is at the right margin: -.bP -The cursor automatically wraps to the beginning of the next line. +.B \%waddch +puts the character +.I ch +at the cursor position of window +.IR win , +then advances the cursor position, +analogously to the standard C library's \fI\%putchar\fP(3). +\fB\%ncurses\fP(3X) describes the variants of this function. +.PP +If advancement occurs at the right margin, .bP -At the bottom of the current scrolling region, -and if \fB\%scrollok\fP(3X) is enabled, -the scrolling region is scrolled up one line. +the cursor automatically wraps to the beginning of the next line; +and .bP -If \fB\%scrollok\fP(3X) is not enabled, -writing a character at the lower right margin succeeds. -However, -an error is returned because it is not possible to wrap to a new line. +at the bottom of the current scrolling region, +and if \fB\%scrollok\fP(3X) is enabled for +.IR win , +the scrolling region scrolls up one line. .PP -If \fIch\fP is a tab, newline, carriage return or backspace, -the cursor is moved appropriately within the window: +If +.I ch +is a +backspace, +carriage return, +line feed, +or +tab, +the cursor moves appropriately within the window. .bP -Backspace moves the cursor one character left; at the left -edge of a window it does nothing. +Backspace moves the cursor one character left; +at the left margin of a window, +it does nothing. .bP -Carriage return moves the cursor to the window left margin on the current line. +Carriage return moves the cursor to the left margin on the current line +of the window. .bP -Newline does a \fBclrtoeol\fP, -then moves the cursor to the window left margin on the next line, -scrolling the window if on the last line. +Line feed does a \fB\%clrtoeol\fP(3X), +then moves the cursor to the left margin on the next line of the window, +scrolling the window if the cursor was already on the last line. .bP -Tabs are considered to be at every eighth column. -The tab interval may be altered by setting the \fBTABSIZE\fP variable. +Tab advances the cursor to the next tab stop +(possibly on the next line); +these are placed at every eighth column by default. +Alter the tab interval with the +.B \%TABSIZE +extension; +see \fB\%curs_variables\fP(3X). .PP -If \fIch\fP is any other nonprintable character, +If +.I ch +is any other nonprintable character, it is drawn in printable form, -using the same convention as \fB\%unctrl\fP(3X): +using the same convention as \fB\%unctrl\fP(3X). .bP -Control characters are displayed in the \fB^\fIX\fR notation. +.B \%waddch +displays control characters in +.BI \*^ X +notation. .bP -Values above 128 are either meta characters +Character codes above 127 are either meta characters (if the screen has not been initialized, -or if \fB\%meta\fP(3X) has been called with a \fBTRUE\fP E parameter), -shown in the \fBM\-\fIX\fR notation, or are displayed as themselves. -In the latter case, the values may not be printable; +or if \fB\%meta\fP(3X) has been called with a +.B TRUE +.I bf +parameter) +that render in +.BI M\- X +notation, +or they display as themselves. +In the latter case, +the values may not be printable; +.\" XXX: The following claim could be clearer. this follows the X/Open specification. .PP -Calling \fBwinch\fP after adding a -nonprintable character does not return the character itself, -but instead returns the printable representation of the character. +Calling \fB\%winch\fP(3X) on the location of a nonprintable character +does not return the character itself, +but its \fB\%unctrl\fP(3X) representation. .PP Video attributes can be combined with a character argument passed to -\fBaddch\fP or related functions by logical-ORing them into the character. -(Thus, text, including attributes, can be copied from one place to another -using \fB\%inch\fP(3X) and \fBaddch\fP.) -See the \fB\%curs_attr\fP(3X) page for values of predefined video -attribute constants that can be usefully OR'ed into characters. +.B \%waddch +by logical-ORing them into the character. +(Thus, +text, +including attributes, +can be copied from one place to another using \fB\%winch\fP(3X) and +.BR \%waddch .) +See \fB\%curs_attr\fP(3X) for values of predefined video attribute +constants that can be usefully OR'ed with characters. .SS "Echoing Characters" -The \fBechochar\fP and \fBwechochar\fP routines are equivalent to a call to -\fBaddch\fP followed by a call to \fB\%refresh\fP(3X), or a call to \fBwaddch\fP -followed by a call to \fBwrefresh\fP. -The knowledge that only a single -character is being output is used and, for non-control characters, a -considerable performance gain may be seen by using these routines instead of -their equivalents. -.SS "Line Graphics" -The following variables may be used to add line drawing characters to the -screen with routines of the \fBaddch\fP family. -The default character listed -below is used if the \fBacsc\fP capability does not define a terminal-specific -replacement for it, -or if the terminal and locale configuration requires Unicode but the -library is unable to use Unicode. -.PP -The names are taken from VT100 nomenclature. +.B \%echochar +and +.B \%wechochar +are equivalent to calling +.RB \%( w ) addch +followed by +.RB \%( w ) refresh . +.I curses +interprets these functions as a hint that only a single character is +being output; +for non-control characters, +a considerable performance gain may be enjoyed by employing them. +.\" TODO: Combine the following with the "Line Drawing" subsection of +.\" terminfo(5) and replace this with a cross reference there. +.SS "Forms-Drawing Characters" +.I curses +defines macros starting with +.B \%ACS_ +that can be used with +.B \%waddch +to write line-drawing and other special characters to the screen. +.I \%ncurses +terms these +.I "forms-drawing characters." +The ACS default listed below is used if the +.B \%acs_chars +.RB ( \%acsc ) +.I \%term\%info +capability does not define a terminal-specific replacement for it, +or if the terminal and locale configuration requires Unicode to access +these characters but the library is unable to use Unicode. +The \*(``acsc char\*('' column corresponds to how the characters are +specified in the +.B \%acs_chars +string capability, +and the characters in it may appear on the screen if the terminal's +database entry incorrectly advertises ACS support. +The name \*(``ACS\*('' originates in the Alternate Character Set feature +of the DEC VT100 terminal. .PP .TS -l l l l -l l l l -_ _ _ _ -l l l l. -\fBACS\fP \fBACS\fP \fBacsc\fP \fBGlyph\fP -\fBName\fP \fBDefault\fP \fBchar\fP \fBName\fP +Lb Lb Lb Lb +Lb Lb Lb Lb +Lb L L Lx. +\& ACS acsc \& +Symbol Default char Glyph Name +_ ACS_BLOCK # 0 solid square block ACS_BOARD # h board of squares ACS_BTEE + v bottom tee -ACS_BULLET o ~ bullet +ACS_BULLET o \*~ bullet ACS_CKBOARD : a checker board (stipple) ACS_DARROW v . arrow pointing down -ACS_DEGREE ' f degree symbol +ACS_DEGREE \*' f degree symbol ACS_DIAMOND + \(ga diamond ACS_GEQUAL > > greater-than-or-equal-to ACS_HLINE \- q horizontal line @@ -176,154 +237,254 @@ ACS_S7 \- r scan line 7 ACS_S9 \&_ s scan line 9 ACS_STERLING f } pound-sterling symbol ACS_TTEE + w top tee -ACS_UARROW ^ \- arrow pointing up +ACS_UARROW \*^ \- arrow pointing up ACS_ULCORNER + l upper left-hand corner ACS_URCORNER + k upper right-hand corner ACS_VLINE | x vertical line .TE .SH RETURN VALUE -All routines return the integer \fBERR\fP upon failure and \fBOK\fP on success -(the SVr4 manuals specify only -\*(``an integer value other than \fBERR\fP\*('') upon successful completion, -unless otherwise noted in the preceding routine descriptions. +These functions return +.B OK +on success and +.B ERR +on failure. .PP -Functions with a \*(``mv\*('' prefix first perform a cursor movement using -\fBwmove\fP, and return an error if the position is outside the window, -or if the window pointer is null. +In +.IR \%ncurses , +.B \%waddch +returns +.B ERR +if it is not possible to add a complete character at the cursor +position, +as when conversion of a multibyte character to a byte sequence fails, +or at least one of the resulting bytes cannot be added to the window. +See section \*(``PORTABILITY\*('' below regarding the use of +.B \%waddch +with multibyte characters. .PP -If it is not possible to add a complete character, -an error is returned: -.bP If \fB\%scrollok\fP(3X) is not enabled, -writing a character at the lower right margin succeeds. +.B \%waddch +can successfully write a character at the bottom right location of the +window. However, -an error is returned because it is not possible to wrap to a new line. -.bP -If an error is detected when converting a multibyte character to a sequence -of bytes, -or if it is not possible to add all of the resulting bytes in the window, -an error is returned. +.I \%ncurses +returns +.B ERR +because it is not possible to wrap to a new line. +.PP +Functions with a \*(``mv\*('' prefix first perform cursor movement using +\fB\%wmove\fP(3X) and fail if the position is outside the window, +or +(for \*(``mvw\*('' functions) +if the +.I \%WINDOW +pointer is null. .SH NOTES -Note that \fBaddch\fP, \fBmvaddch\fP, \fBmvwaddch\fP, and -\fBechochar\fP may be macros. +.BR \%addch , +.BR \%mvaddch , +.BR \%mvwaddch , +and +.B \%echochar +may be implemented as macros. .SH PORTABILITY -These functions are described in the XSI Curses standard, Issue 4. -The defaults specified for forms-drawing characters apply in the POSIX locale. +X/Open Curses, +Issue 4 describes these functions. +It specifies no error conditions for them. +The defaults specified for forms-drawing characters apply in the POSIX +locale. .SS "ACS Symbols" -X/Open Curses states that the \fBACS_\fP definitions are \fBchar\fP constants. -For the wide-character implementation (see \fBcurs_add_wch\fP), -there are analogous \fBWACS_\fP definitions which are \fBcchar_t\fP constants. -Some implementations are problematic: +X/Open Curses states that the +.B \%ACS_ +definitions are +.I char +constants. +.PP +Some implementations are problematic. .bP -Some implementations define the ACS symbols to a constant -(such as Solaris), while others define those to entries in an array. +Solaris +.IR curses , +for example, +define the ACS symbols as constants; +others define them as elements of an array. .IP -This implementation uses an array \fBacs_map\fP, as done in SVr4 curses. -NetBSD also uses an array, actually named \fB_acs_char\fP, with a \fB#define\fP +This implementation uses an array, +.BR \%acs_map , +as did SVr4 +.IR curses . +NetBSD also uses an array, +actually named +.BR \%_acs_char , +with a +.B \%#define for compatibility. .bP -HP-UX curses equates some of the \fBACS_\fP symbols -to the analogous \fBWACS_\fP symbols as if the \fBACS_\fP symbols were -wide characters. -The misdefined symbols are the arrows -and other symbols which are not used for line-drawing. +HP-UX +.I curses +equates some of the +.B \%ACS_ +symbols to the analogous +.B \%WACS_ +symbols as if the +.B \%ACS_ +symbols were wide characters +(see \fB\%curs_add_wch\fP(3X)). +The misdefined symbols are the arrows and others that are not used for +line drawing. .bP -X/Open Curses (issues 2 through 7) has a typographical error -for the ACS_LANTERN symbol, equating its \*(``VT100+ Character\*('' -to \fBI\fP (capital I), while the header files for SVr4 curses -and the various implementations use \fBi\fP (lowercase). +X/Open Curses +(Issues 2 through 7) +has a typographical error +for the +.B \%ACS_LANTERN +symbol, equating its \*(``VT100+ Character\*('' to \*(``I\*('' +(capital I), +while the header files for SVr4 +.I curses +and other implementations use \*(``i\*('' +(small i). .IP -None of the terminal descriptions on Unix platforms use uppercase-I, -except for Solaris (i.e., \fBscreen\fP's terminal description, +None of the terminal descriptions on Unix platforms use uppercase I, +except for Solaris +(in its +.I \%term\%info +entry for \fI\%screen\fP(1), apparently based on the X/Open documentation around 1995). -On the other hand, the terminal description \fIgs6300\fP -(AT&T PC6300 with EMOTS Terminal Emulator) uses lowercase-i. -.LP +On the other hand, +its +.B \%gs6300 +(AT&T PC6300 with EMOTS Terminal Emulator) +description uses lowercase i. +.PP Some ACS symbols -(ACS_S3, -ACS_S7, -ACS_LEQUAL, -ACS_GEQUAL, -ACS_PI, -ACS_NEQUAL, -ACS_STERLING) -were not documented in -any publicly released System V. -However, many publicly available terminfos -include \fBacsc\fP strings in which their key characters (pryz{|}) are -embedded, and a second-hand list of their character descriptions has come -to light. -The ACS-prefixed names for them were invented for \fB\%ncurses\fP(3X). -.LP -The \fIdisplayed\fP values for the \fBACS_\fP and \fBWACS_\fP constants -depend on +.RB ( \%ACS_S3 , +.BR \%ACS_S7 , +.BR \%ACS_LEQUAL , +.BR \%ACS_GEQUAL , +.BR \%ACS_PI , +.BR \%ACS_NEQUAL , +and +.BR \%ACS_STERLING ) +were not documented in any publicly released System\ V. +However, +many publicly available +.I \%term\%info +entries include +.B \%acsc +strings in which their key characters (pryz{|}) are embedded, +and a second-hand list of their character descriptions has come to +light. +The +.I \%ncurses +developers invented ACS-prefixed names for them. +.PP +The +.I displayed +values of +.B \%ACS_ +constants depend on .bP -the library configuration, -i.e., -\fI\%ncurses\fP versus \fI\%ncursesw\fP, -where the latter is capable of displaying Unicode while the former is not, and +the +.I \%ncurses +ABI\(emfor example, +wide-character versus non-wide-character configurations +(the former is capable of displaying Unicode while the latter is not), +and .bP -whether the \fIlocale\fP uses UTF-8 encoding. -.LP -In certain cases, the terminal is unable to display line-drawing characters -except by using UTF-8 -(see the discussion of \fB\%NCURSES_NO_UTF8_ACS\fP in -\fB\%ncurses\fP(3X)). +whether the locale uses UTF-8 encoding. +.PP +In certain cases, +the terminal is unable to display forms-drawing characters +.I except +by using UTF-8; +see the discussion of the +.I \%NCURSES_NO_UTF8_ACS +environment variable in \fB\%ncurses\fP(3X)). .SS "Character Set" -X/Open Curses assumes that the parameter passed to \fBwaddch\fP contains -a single character. -As discussed in \fB\%curs_attr\fP(3X), that character may have been -more than eight bits in an SVr3 or SVr4 implementation, -but in the X/Open Curses model, the details are not given. -The important distinction between SVr4 curses and X/Open Curses is -that the non-character information (attributes and color) was -separated from the character information which is packed in a \fBchtype\fP -to pass to \fBwaddch\fP. +X/Open Curses assumes that the parameter passed to +.B \%waddch +contains a single character. +As discussed in \fB\%curs_attr\fP(3X), +that character may have been more than eight bits wide in an SVr3 or +SVr4 implementation, +but in the X/Open Curses model, +the details are not given. +The important distinction between SVr4 +.I curses +and X/Open Curses is that the latter separates non-character information +(attributes and color) +from the character code, +which SVr4 packs into a +.I \%chtype +for passage to +.BR \%waddch . .PP -In this implementation, \fBchtype\fP holds an eight-bit character. -But \fI\%ncurses\fP allows multibyte characters to be passed in a -succession of calls to \fBwaddch\fP. -The other implementations do not do this; -a call to \fBwaddch\fP passes exactly one character -which may be rendered as one or more cells on the screen -depending on whether it is printable. +In +.IR \%ncurses , +.I \%chtype +holds an eight-bit character. +But +.I \%ncurses +allows a multibyte character to be passed in a succession of calls to +.BR \%waddch . +Other implementations do not; +a +.B \%waddch +call transmits exactly one character, +which may be rendered in one or more screen locations depending on +whether it is printable. .PP Depending on the locale settings, -\fI\%ncurses\fP will inspect the byte passed in each call to \fBwaddch\fP, -and check if the latest call will continue a multibyte sequence. -When a character is \fIcomplete\fP, -\fI\%ncurses\fP displays the character and moves to the next position in the screen. +.I \%ncurses +inspects the byte passed in each +.B \%waddch +call, +and checks whether the latest call continues a multibyte sequence. +When a character is +.IR complete , +.I \%ncurses +displays the character and advances the window's current location. .PP If the calling application interrupts the succession of bytes in -a multibyte character by moving the current location (e.g., using \fBwmove\fP), -\fI\%ncurses\fP discards the partially built character, -starting over again. +a multibyte character sequence by moving the current location +(for example, +with \fB\%wmove\fP(3X)), +.I \%ncurses +discards the incomplete character. .PP For portability to other implementations, -do not rely upon this behavior: +do not rely upon this behavior. +Check whether a character can be represented as a single byte in the +current locale. .bP -check if a character can be represented as a single byte in the current locale -before attempting call \fBwaddch\fP, and +If it can, +call either +.B \%waddch +or \fB\%wadd_wch\fP(3X). .bP -call \fBwadd_wch\fP for characters which cannot be handled by \fBwaddch\fP. +If it cannot, +use only +\fB\%wadd_wch\fP(3X). .SS TABSIZE -The \fBTABSIZE\fP variable is implemented in SVr4 and other versions of curses, -but is not part of X/Open curses -(see \fBcurs_variables\fP(3X) for more details). -.LP -If \fIch\fP is a carriage return, -the cursor is moved to the beginning of the current row of the window. -This is true of other implementations, but is not documented. +SVr4 and other versions of +.I curses +implement the +.B \%TABSIZE +variable, +but X/Open Curses does not specify it +(see \fB\%curs_variables\fP(3X)). .SH SEE ALSO \fB\%curses\fP(3X), +\fB\%curs_addchstr\fP(3X), +\fB\%curs_addstr\fP(3X), \fB\%curs_attr\fP(3X), \fB\%curs_clear\fP(3X), \fB\%curs_inch\fP(3X), \fB\%curs_outopts\fP(3X), \fB\%curs_refresh\fP(3X), \fB\%curs_variables\fP(3X), -\fB\%putc\fP(3) +\fB\%putchar\fP(3) .PP -Comparable functions in the wide-character (ncursesw) library are -described in -\fB\%curs_add_wch\fP(3X). +\fB\%curs_add_wch\fP(3X) describes comparable functions of the +.I \%ncurses +library in its wide-character configuration +.RI ( \%ncursesw ). diff --git a/upstream/mageia-cauldron/man3/curs_addchstr.3x b/upstream/mageia-cauldron/man3/curs_addchstr.3x index 9e8db986..096ac98a 100644 --- a/upstream/mageia-cauldron/man3/curs_addchstr.3x +++ b/upstream/mageia-cauldron/man3/curs_addchstr.3x @@ -1,5 +1,5 @@ .\"*************************************************************************** -.\" Copyright 2019-2022,2023 Thomas E. Dickey * +.\" Copyright 2019-2023,2024 Thomas E. Dickey * .\" Copyright 1998-2012,2017 Free Software Foundation, Inc. * .\" * .\" Permission is hereby granted, free of charge, to any person obtaining a * @@ -27,8 +27,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: curs_addchstr.3x,v 1.38 2023/11/25 14:01:49 tom Exp $ -.TH curs_addchstr 3X 2023-11-25 "ncurses 6.4" "Library calls" +.\" $Id: curs_addchstr.3x,v 1.40 2024/03/16 15:37:51 tom Exp $ +.TH curs_addchstr 3X 2024-03-16 "ncurses 6.4" "Library calls" .ie \n(.g \{\ .ds `` \(lq .ds '' \(rq @@ -96,7 +96,7 @@ rather than wrapping it around to the new line. .SH RETURN VALUE All functions return the integer \fBERR\fP upon failure and \fBOK\fP on success. .PP -X/Open does not define any error conditions. +X/Open Curses does not specify any error conditions. This implementation returns an error .bP if the \fIwin\fP parameter is null or @@ -113,6 +113,9 @@ These functions are described in the XSI Curses standard, Issue 4. .SH SEE ALSO \fB\%curses\fP(3X), \fB\%curs_addch\fP(3X), -\fB\%curs_addstr\fP(3X), -\fB\%curs_addwstr\fP(3X), -\fB\%curs_add_wchstr\fP(3X) +\fB\%curs_addstr\fP(3X) +.PP +\fB\%curs_add_wchstr\fP(3X) describes comparable functions of the +.I \%ncurses +library in its wide-character configuration +.RI ( \%ncursesw ). diff --git a/upstream/mageia-cauldron/man3/curs_addstr.3x b/upstream/mageia-cauldron/man3/curs_addstr.3x index 8db64ada..78294f6b 100644 --- a/upstream/mageia-cauldron/man3/curs_addstr.3x +++ b/upstream/mageia-cauldron/man3/curs_addstr.3x @@ -1,5 +1,5 @@ .\"*************************************************************************** -.\" Copyright 2019-2022,2023 Thomas E. Dickey * +.\" Copyright 2019-2023,2024 Thomas E. Dickey * .\" Copyright 1998-2012,2017 Free Software Foundation, Inc. * .\" * .\" Permission is hereby granted, free of charge, to any person obtaining a * @@ -27,8 +27,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: curs_addstr.3x,v 1.37 2023/11/18 21:18:55 tom Exp $ -.TH curs_addstr 3X 2023-11-18 "ncurses 6.4" "Library calls" +.\" $Id: curs_addstr.3x,v 1.41 2024/03/23 20:38:57 tom Exp $ +.TH curs_addstr 3X 2024-03-23 "ncurses 6.4" "Library calls" .ie \n(.g \{\ .ds `` \(lq .ds '' \(rq @@ -59,50 +59,79 @@ add a string to a \fIcurses\fR window and advance the cursor \fB#include <curses.h> .PP \fBint addstr(const char *\fIstr\fP); -\fBint addnstr(const char *\fIstr\fP, int \fIn\fP); +\fBint mvaddstr(int \fIy\fP, int \fIx\fP, const char *\fIstr\fP); +\fBint mvwaddstr(WINDOW *\fIwin\fP, int \fIy\fP, int \fIx\fP, const char *\fIstr\fP); \fBint waddstr(WINDOW *\fIwin\fP, const char *\fIstr\fP); -\fBint waddnstr(WINDOW *\fIwin\fP, const char *\fIstr\fP, int \fIn\fP); .PP -\fBint mvaddstr(int \fIy\fP, int \fIx\fP, const char *\fIstr\fP); +\fBint addnstr(const char *\fIstr\fP, int \fIn\fP); \fBint mvaddnstr(int \fIy\fP, int \fIx\fP, const char *\fIstr\fP, int \fIn\fP); -\fBint mvwaddstr(WINDOW *\fIwin\fP, int \fIy\fP, int \fIx\fP, const char *\fIstr\fP); \fBint mvwaddnstr(WINDOW *\fIwin\fP, int \fIy\fP, int \fIx\fP, const char *\fIstr\fP, int \fIn\fP); +\fBint waddnstr(WINDOW *\fIwin\fP, const char *\fIstr\fP, int \fIn\fP); .fi .SH DESCRIPTION -These functions write the (null-terminated) character string -\fIstr\fP on the given window. -It is similar to calling \fBwaddch\fP once for each byte in the string. +.B waddstr +writes the characters of the (null-terminated) string +.I str +to the window +.IR win . +Its process is similar to calling \fB\%waddch\fP(3X) for each +.I char +in +.IR str . +Control characters are processed as in \fB\%waddch\fP(3X). .PP -The \fImv\fP functions perform cursor movement once, before writing any -characters. -Thereafter, the cursor is advanced as a side-effect of writing to the window. +.B waddnstr +writes at most +.I n +characters, +or until a terminating null character occurs in +.IR str . +If +.I n +is \-1, +.B +.B waddnstr +writes the entire string. .PP -The four functions with \fIn\fP as the last argument -write at most \fIn\fP bytes, -or until a terminating null is reached. -If \fIn\fP is \-1, then the entire string will be added. +\fB\%ncurses\fP(3X) describes the variants of these functions. .SH RETURN VALUE -All functions return the integer \fBERR\fP upon failure and \fBOK\fP on success. +These functions return +.B OK +on success and +.B ERR +on failure. .PP -X/Open does not define any error conditions. -This implementation returns an error +X/Open Curses does not specify any error conditions. +.I \%ncurses +returns an error .bP -if the window pointer is null or +if the window pointer is +.BR NULL , .bP -if the string pointer is null or +if the string pointer is +.BR NULL , +or .bP -if the corresponding calls to \fBwaddch\fP return an error. +if an internal \fB\%waddch\fP(3X) call returns an error. .PP -Functions with a \*(``mv\*('' prefix first perform a cursor movement using -\fBwmove\fP, and return an error if the position is outside the window, -or if the window pointer is null. +Functions with a \*(``mv\*('' prefix first perform cursor movement using +\fB\%wmove\fP(3X) and fail if the position is outside the window, +or +(for \*(``mvw\*('' functions) +if the +.I \%WINDOW +pointer is null. .SH NOTES All of these functions except \fBwaddnstr\fP may be macros. .SH PORTABILITY -These functions are described in the XSI Curses standard, Issue 4. +X/Open Curses, +Issue 4 describes these functions. .SH SEE ALSO \fB\%curses\fP(3X), \fB\%curs_addch\fP(3X), -\fB\%curs_addchstr\fP(3X), -\fB\%curs_addwstr\fP(3X), -\fB\%curs_add_wchstr\fP(3X) +\fB\%curs_addchstr\fP(3X) +.PP +\fB\%curs_addwstr\fP(3X) describes comparable functions of the +.I \%ncurses +library in its wide-character configuration +.RI ( \%ncursesw ). diff --git a/upstream/mageia-cauldron/man3/curs_addwstr.3x b/upstream/mageia-cauldron/man3/curs_addwstr.3x index ff8240bc..f9f88639 100644 --- a/upstream/mageia-cauldron/man3/curs_addwstr.3x +++ b/upstream/mageia-cauldron/man3/curs_addwstr.3x @@ -1,5 +1,5 @@ .\"*************************************************************************** -.\" Copyright 2019-2022,2023 Thomas E. Dickey * +.\" Copyright 2019-2023,2024 Thomas E. Dickey * .\" Copyright 2002-2012,2017 Free Software Foundation, Inc. * .\" * .\" Permission is hereby granted, free of charge, to any person obtaining a * @@ -27,8 +27,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: curs_addwstr.3x,v 1.29 2023/11/18 21:18:55 tom Exp $ -.TH curs_addwstr 3X 2023-11-18 "ncurses 6.4" "Library calls" +.\" $Id: curs_addwstr.3x,v 1.33 2024/03/23 20:38:57 tom Exp $ +.TH curs_addwstr 3X 2024-03-23 "ncurses 6.4" "Library calls" .ie \n(.g \{\ .ds `` \(lq .ds '' \(rq @@ -59,59 +59,90 @@ add a wide-character string to a \fIcurses\fR window and advance the cursor \fB#include <curses.h> .PP \fBint addwstr(const wchar_t *\fIwstr\fP); -\fBint addnwstr(const wchar_t *\fIwstr\fP, int \fIn\fP); +\fBint mvaddwstr(int \fIy\fP, int \fIx\fP, const wchar_t *\fIwstr\fP); +\fBint mvwaddwstr(WINDOW *\fIwin\fP, int \fIy\fP, int \fIx\fP, const wchar_t *\fIwstr\fP); \fBint waddwstr(WINDOW *\fIwin\fP, const wchar_t *\fIwstr\fP); -\fBint waddnwstr(WINDOW *\fIwin\fP, const wchar_t *\fIwstr\fP, int \fIn\fP); .PP -\fBint mvaddwstr(int \fIy\fP, int \fIx\fP, const wchar_t *\fIwstr\fP); +\fBint addnwstr(const wchar_t *\fIwstr\fP, int \fIn\fP); \fBint mvaddnwstr(int \fIy\fP, int \fIx\fP, const wchar_t *\fIwstr\fP, int \fIn\fP); -\fBint mvwaddwstr(WINDOW *\fIwin\fP, int \fIy\fP, int \fIx\fP, const wchar_t *\fIwstr\fP); \fBint mvwaddnwstr(WINDOW *\fIwin\fP, int \fIy\fP, int \fIx\fP, const wchar_t *\fIwstr\fP, int \fIn\fP); +\fBint waddnwstr(WINDOW *\fIwin\fP, const wchar_t *\fIwstr\fP, int \fIn\fP); .fi .SH DESCRIPTION -These functions write the characters of the -(null-terminated) \fBwchar_t\fP character string -\fIwstr\fP on the given window. -It is similar to constructing a \fBcchar_t\fP for -each \fBwchar_t\fR in the string, -then calling \fBwadd_wch\fP(3X) for the resulting \fBcchar_t\fP: +.B waddwstr +writes the characters of the (wide-null-terminated) wide-character +string +.I wstr +to the window +.IR win . +Its process is similar to constructing a +.I cchar_t +for each +.I wchar_t +in +.IR wstr , +then calling \fB\%wadd_wch\fP(3X) with the resulting +.IR cchar_t . .bP -spacing and non-spacing characters in the string -are processed one at a time, and +Spacing and non-spacing characters in the string +are processed one at a time, +and .bP -control characters are processed as in \fBwaddch\fP(3X). +control characters are processed as in \fB\%wadd_wch\fP(3X). .PP -The \fImv\fP functions perform cursor movement once, before writing any -characters. -Thereafter, the cursor is advanced as a side-effect of writing to the window. +.B waddnwstr +writes at most +.I n +wide characters, +or until a terminating wide null character occurs in +.IR wstr . +If +.I n +is \-1, +.B +.B waddnwstr +writes the entire wide string. .PP -The four functions with \fIn\fP as the last argument -write at most \fIn\fP \fBwchar_t\fP characters, -or until a terminating null is reached. -If \fIn\fP is \-1, then the entire string will be added. +\fB\%ncurses\fP(3X) describes the variants of these functions. .SH RETURN VALUE -All functions return the integer \fBERR\fP upon failure and \fBOK\fP on success. +These functions return +.B OK +on success and +.B ERR +on failure. .PP -X/Open does not define any error conditions. -This implementation returns an error +X/Open Curses does not specify any error conditions. +.I \%ncurses +returns an error .bP -if the window pointer is null or +if the window pointer is +.BR NULL , .bP -if the string pointer is null or +if the string pointer is +.BR NULL , +or .bP -if the corresponding calls to \fBwadd_wch\fP return an error. +if an internal \fB\%wadd_wch\fP(3X) call returns an error. .PP -Functions with a \*(``mv\*('' prefix first perform a cursor movement using -\fBwmove\fP, and return an error if the position is outside the window, -or if the window pointer is null. +Functions with a \*(``mv\*('' prefix first perform cursor movement using +\fB\%wmove\fP(3X) and fail if the position is outside the window, +or +(for \*(``mvw\*('' functions) +if the +.I \%WINDOW +pointer is null. .SH NOTES -All of these functions except \fBwaddnwstr\fP may be macros. +All of these functions except +.B waddnwstr +may be implemented as macros. .SH PORTABILITY -These functions are described in the XSI Curses standard, Issue 4. +X/Open Curses, +Issue 4 describes these functions. .SH SEE ALSO \fB\%curses\fP(3X), -\fB\%curs_addch\fP(3X), -\fB\%curs_addchstr\fP(3X), -\fB\%curs_addstr\fP(3X), \fB\%curs_add_wch\fP(3X), \fB\%curs_add_wchstr\fP(3X) +.PP +\fB\%curs_addstr\fP(3X) describes comparable functions of the +.I \%ncurses +library in its non-wide-character configuration. diff --git a/upstream/mageia-cauldron/man3/curs_attr.3x b/upstream/mageia-cauldron/man3/curs_attr.3x index 3053c350..8fe4620a 100644 --- a/upstream/mageia-cauldron/man3/curs_attr.3x +++ b/upstream/mageia-cauldron/man3/curs_attr.3x @@ -28,8 +28,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: curs_attr.3x,v 1.96 2024/01/13 22:05:39 tom Exp $ -.TH curs_attr 3X 2024-01-13 "ncurses 6.4" "Library calls" +.\" $Id: curs_attr.3x,v 1.99 2024/03/16 15:38:33 tom Exp $ +.TH curs_attr 3X 2024-03-16 "ncurses 6.4" "Library calls" .ie \n(.g \{\ .ds `` \(lq .ds '' \(rq @@ -232,7 +232,7 @@ The routine \fBstandend\fP is the same as \fBattrset(A_NORMAL)\fP or \fBattrset(0)\fP, that is, it turns off all attributes. .PP -X/Open does not mark these \*(``restricted\*('', because +X/Open Curses does not mark these \*(``restricted\*('', because .bP they have well established legacy use, and .bP @@ -296,7 +296,7 @@ The SVr4 manual page claims (falsely) that these routines always return \fB1\fP. .SH RETURN VALUE All routines return the integer \fBOK\fP on success, or \fBERR\fP on failure. .PP -X/Open does not define any error conditions. +X/Open Curses does not specify any error conditions. .PP This implementation .bP @@ -512,7 +512,7 @@ but not necessarily the reverse. .PP .TS Lb Lb Lb Cb S Lb -Lb2 Lb Lb2 Lbz Lb2 Lb +Lb2 Lb Lb2 Lb2 Lb2 Lb L L L L L Lx. \& \& \& Bits \& Year System Arch Color Char Notes diff --git a/upstream/mageia-cauldron/man3/curs_beep.3x b/upstream/mageia-cauldron/man3/curs_beep.3x index f5bd11ae..a8bde8de 100644 --- a/upstream/mageia-cauldron/man3/curs_beep.3x +++ b/upstream/mageia-cauldron/man3/curs_beep.3x @@ -1,5 +1,5 @@ .\"*************************************************************************** -.\" Copyright 2018-2021,2023 Thomas E. Dickey * +.\" Copyright 2018-2023,2024 Thomas E. Dickey * .\" Copyright 1998-2005,2010 Free Software Foundation, Inc. * .\" * .\" Permission is hereby granted, free of charge, to any person obtaining a * @@ -27,8 +27,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: curs_beep.3x,v 1.25 2023/10/07 21:19:07 tom Exp $ -.TH curs_beep 3X 2023-10-07 "ncurses 6.4" "Library calls" +.\" $Id: curs_beep.3x,v 1.27 2024/03/16 15:35:01 tom Exp $ +.TH curs_beep 3X 2024-03-16 "ncurses 6.4" "Library calls" .SH NAME \fB\%beep\fP, \fB\%flash\fP \- diff --git a/upstream/mageia-cauldron/man3/curs_bkgd.3x b/upstream/mageia-cauldron/man3/curs_bkgd.3x index 15a5e649..e94e640e 100644 --- a/upstream/mageia-cauldron/man3/curs_bkgd.3x +++ b/upstream/mageia-cauldron/man3/curs_bkgd.3x @@ -1,5 +1,5 @@ .\"*************************************************************************** -.\" Copyright 2018-2022,2023 Thomas E. Dickey * +.\" Copyright 2018-2023,2024 Thomas E. Dickey * .\" Copyright 1998-2015,2017 Free Software Foundation, Inc. * .\" * .\" Permission is hereby granted, free of charge, to any person obtaining a * @@ -27,8 +27,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: curs_bkgd.3x,v 1.55 2023/12/23 16:35:10 tom Exp $ -.TH curs_bkgd 3X 2023-12-23 "ncurses 6.4" "Library calls" +.\" $Id: curs_bkgd.3x,v 1.59 2024/03/23 19:58:58 tom Exp $ +.TH curs_bkgd 3X 2024-03-23 "ncurses 6.4" "Library calls" .ie \n(.g \{\ .ds `` \(lq .ds '' \(rq @@ -208,9 +208,9 @@ written to the screen during the refresh. Neither X/Open Curses nor the SVr4 manual pages detail how the rendition of characters on the screen updates when \fB\%bkgd\fP or \fB\%wbkgd\fP changes the background character. -.I \%ncurses, +.IR \%ncurses , like SVr4 -.I curses, +.IR curses , does not (in its non-\*(``wide\*('' configuration) store the background and window attribute contributions to each @@ -218,7 +218,7 @@ character cell separately. .SH SEE ALSO \fB\%curs_bkgrnd\fP(3X) describes the corresponding functions in the \*(``wide\*('' configuration of -.I \%ncurses. +.IR \%ncurses . .PP \fB\%curses\fP(3X), \fB\%curs_addch\fP(3X), diff --git a/upstream/mageia-cauldron/man3/curs_bkgrnd.3x b/upstream/mageia-cauldron/man3/curs_bkgrnd.3x index b80bf049..5f8ba602 100644 --- a/upstream/mageia-cauldron/man3/curs_bkgrnd.3x +++ b/upstream/mageia-cauldron/man3/curs_bkgrnd.3x @@ -1,5 +1,5 @@ .\"*************************************************************************** -.\" Copyright 2018-2022,2023 Thomas E. Dickey * +.\" Copyright 2018-2023,2024 Thomas E. Dickey * .\" Copyright 2002-2015,2017 Free Software Foundation, Inc. * .\" * .\" Permission is hereby granted, free of charge, to any person obtaining a * @@ -27,8 +27,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: curs_bkgrnd.3x,v 1.36 2023/12/23 16:35:10 tom Exp $ -.TH curs_bkgrnd 3X 2023-12-23 "ncurses 6.4" "Library calls" +.\" $Id: curs_bkgrnd.3x,v 1.40 2024/03/23 19:59:45 tom Exp $ +.TH curs_bkgrnd 3X 2024-03-23 "ncurses 6.4" "Library calls" .ie \n(.g \{\ .ds `` \(lq .ds '' \(rq @@ -171,7 +171,7 @@ upon failure and .B OK upon success. In -.I \%ncurses, +.IR \%ncurses , failure occurs if .bP a @@ -192,7 +192,7 @@ is null. may be implemented as macros. .PP Unlike their counterparts in the non-\*(``wide\*('' configuration of -.I \%ncurses, +.IR \%ncurses , \fB\%getbkgrnd\fP and \fB\%wgetbkgrnd\fP supply the background character and attribute in a modifiable .I \%cchar_t @@ -204,11 +204,11 @@ It specifies no error conditions for them. .PP X/Open Curses does not provide details of how the rendition is updated. This implementation follows the approach used in SVr4 -.I curses. +.IR curses . .SH SEE ALSO \fB\%curs_bkgd\fP(3X) describes the corresponding functions in the non-\*(``wide\*('' configuration of -.I \%ncurses. +.IR \%ncurses . .PP \fB\%curses\fP(3X), \fB\%curs_add_wch\fP(3X), diff --git a/upstream/mageia-cauldron/man3/curs_border.3x b/upstream/mageia-cauldron/man3/curs_border.3x index 5d5bdcea..9f3d37fd 100644 --- a/upstream/mageia-cauldron/man3/curs_border.3x +++ b/upstream/mageia-cauldron/man3/curs_border.3x @@ -1,5 +1,5 @@ .\"*************************************************************************** -.\" Copyright 2018-2022,2023 Thomas E. Dickey * +.\" Copyright 2018-2023,2024 Thomas E. Dickey * .\" Copyright 1998-2007,2010 Free Software Foundation, Inc. * .\" * .\" Permission is hereby granted, free of charge, to any person obtaining a * @@ -27,8 +27,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: curs_border.3x,v 1.44 2023/12/16 21:09:11 tom Exp $ -.TH curs_border 3X 2023-12-16 "ncurses 6.4" "Library calls" +.\" $Id: curs_border.3x,v 1.46 2024/03/16 15:38:43 tom Exp $ +.TH curs_border 3X 2024-03-16 "ncurses 6.4" "Library calls" .ie \n(.g \{\ .ds `` \(lq .ds '' \(rq @@ -141,7 +141,7 @@ The SVr4.0 manual says \*(``or a non-negative integer if \fB\%immedok\fP is set\*('', but this appears to be an error. .PP -X/Open does not define any error conditions. +X/Open Curses does not specify any error conditions. This implementation returns an error if the window pointer is null. .PP diff --git a/upstream/mageia-cauldron/man3/curs_border_set.3x b/upstream/mageia-cauldron/man3/curs_border_set.3x index 16a66ce5..2cbd792d 100644 --- a/upstream/mageia-cauldron/man3/curs_border_set.3x +++ b/upstream/mageia-cauldron/man3/curs_border_set.3x @@ -1,5 +1,5 @@ .\"*************************************************************************** -.\" Copyright 2019-2022,2023 Thomas E. Dickey * +.\" Copyright 2019-2023,2024 Thomas E. Dickey * .\" Copyright 2002-2011,2012 Free Software Foundation, Inc. * .\" * .\" Permission is hereby granted, free of charge, to any person obtaining a * @@ -27,8 +27,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: curs_border_set.3x,v 1.31 2023/11/25 15:39:56 tom Exp $ -.TH curs_border_set 3X 2023-11-25 "ncurses 6.4" "Library calls" +.\" $Id: curs_border_set.3x,v 1.33 2024/03/16 15:35:01 tom Exp $ +.TH curs_border_set 3X 2024-03-16 "ncurses 6.4" "Library calls" .ie \n(.g \{\ .ds `` \(lq .ds '' \(rq diff --git a/upstream/mageia-cauldron/man3/curs_clear.3x b/upstream/mageia-cauldron/man3/curs_clear.3x index b81273e8..93c45b93 100644 --- a/upstream/mageia-cauldron/man3/curs_clear.3x +++ b/upstream/mageia-cauldron/man3/curs_clear.3x @@ -27,8 +27,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: curs_clear.3x,v 1.44 2024/01/05 21:46:58 tom Exp $ -.TH curs_clear 3X 2024-01-05 "ncurses 6.4" "Library calls" +.\" $Id: curs_clear.3x,v 1.46 2024/03/16 15:35:01 tom Exp $ +.TH curs_clear 3X 2024-03-16 "ncurses 6.4" "Library calls" .ie \n(.g \{\ .ds `` \(lq .ds '' \(rq diff --git a/upstream/mageia-cauldron/man3/curs_color.3x b/upstream/mageia-cauldron/man3/curs_color.3x index 0fb6dcc4..7bbf85d5 100644 --- a/upstream/mageia-cauldron/man3/curs_color.3x +++ b/upstream/mageia-cauldron/man3/curs_color.3x @@ -1,5 +1,5 @@ .\"*************************************************************************** -.\" Copyright 2018-2022,2023 Thomas E. Dickey * +.\" Copyright 2018-2023,2024 Thomas E. Dickey * .\" Copyright 1998-2016,2017 Free Software Foundation, Inc. * .\" * .\" Permission is hereby granted, free of charge, to any person obtaining a * @@ -27,8 +27,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: curs_color.3x,v 1.96 2023/12/30 21:20:01 tom Exp $ -.TH curs_color 3X 2023-12-30 "ncurses 6.4" "Library calls" +.\" $Id: curs_color.3x,v 1.98 2024/03/16 15:35:01 tom Exp $ +.TH curs_color 3X 2024-03-16 "ncurses 6.4" "Library calls" .ie \n(.g \{\ .ds `` \(lq .ds '' \(rq diff --git a/upstream/mageia-cauldron/man3/curs_delch.3x b/upstream/mageia-cauldron/man3/curs_delch.3x index 2f42bf02..e94d9fac 100644 --- a/upstream/mageia-cauldron/man3/curs_delch.3x +++ b/upstream/mageia-cauldron/man3/curs_delch.3x @@ -1,5 +1,5 @@ .\"*************************************************************************** -.\" Copyright 2018-2022,2023 Thomas E. Dickey * +.\" Copyright 2018-2023,2024 Thomas E. Dickey * .\" Copyright 1998-2006,2010 Free Software Foundation, Inc. * .\" * .\" Permission is hereby granted, free of charge, to any person obtaining a * @@ -27,8 +27,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: curs_delch.3x,v 1.30 2023/12/16 21:09:11 tom Exp $ -.TH curs_delch 3X 2023-12-16 "ncurses 6.4" "Library calls" +.\" $Id: curs_delch.3x,v 1.32 2024/03/16 15:35:01 tom Exp $ +.TH curs_delch 3X 2024-03-16 "ncurses 6.4" "Library calls" .ie \n(.g \{\ .ds `` \(lq .ds '' \(rq diff --git a/upstream/mageia-cauldron/man3/curs_deleteln.3x b/upstream/mageia-cauldron/man3/curs_deleteln.3x index 29b8bb57..a79978a1 100644 --- a/upstream/mageia-cauldron/man3/curs_deleteln.3x +++ b/upstream/mageia-cauldron/man3/curs_deleteln.3x @@ -1,5 +1,5 @@ .\"*************************************************************************** -.\" Copyright 2018-2022,2023 Thomas E. Dickey * +.\" Copyright 2018-2023,2024 Thomas E. Dickey * .\" Copyright 1998-2007,2010 Free Software Foundation, Inc. * .\" * .\" Permission is hereby granted, free of charge, to any person obtaining a * @@ -27,8 +27,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: curs_deleteln.3x,v 1.34 2023/12/16 21:33:34 tom Exp $ -.TH curs_deleteln 3X 2023-12-16 "ncurses 6.4" "Library calls" +.\" $Id: curs_deleteln.3x,v 1.36 2024/03/16 15:35:01 tom Exp $ +.TH curs_deleteln 3X 2024-03-16 "ncurses 6.4" "Library calls" .ie \n(.g \{\ .ds `` \(lq .ds '' \(rq diff --git a/upstream/mageia-cauldron/man3/curs_extend.3x b/upstream/mageia-cauldron/man3/curs_extend.3x index 6c2a54a3..c6547894 100644 --- a/upstream/mageia-cauldron/man3/curs_extend.3x +++ b/upstream/mageia-cauldron/man3/curs_extend.3x @@ -1,5 +1,5 @@ .\"*************************************************************************** -.\" Copyright 2018-2022,2023 Thomas E. Dickey * +.\" Copyright 2018-2023,2024 Thomas E. Dickey * .\" Copyright 1999-2010,2016 Free Software Foundation, Inc. * .\" * .\" Permission is hereby granted, free of charge, to any person obtaining a * @@ -29,8 +29,8 @@ .\" .\" Author: Thomas E. Dickey 1999-on .\" -.\" $Id: curs_extend.3x,v 1.44 2023/12/23 16:36:18 tom Exp $ -.TH curs_extend 3X 2023-12-23 "ncurses 6.4" "Library calls" +.\" $Id: curs_extend.3x,v 1.46 2024/03/16 15:35:01 tom Exp $ +.TH curs_extend 3X 2024-03-16 "ncurses 6.4" "Library calls" .ie \n(.g \{\ .ds `` \(lq .ds '' \(rq diff --git a/upstream/mageia-cauldron/man3/curs_get_wch.3x b/upstream/mageia-cauldron/man3/curs_get_wch.3x index dc62c156..6ac80dd1 100644 --- a/upstream/mageia-cauldron/man3/curs_get_wch.3x +++ b/upstream/mageia-cauldron/man3/curs_get_wch.3x @@ -1,5 +1,5 @@ .\"*************************************************************************** -.\" Copyright 2018-2022,2023 Thomas E. Dickey * +.\" Copyright 2018-2023,2024 Thomas E. Dickey * .\" Copyright 2002-2016,2017 Free Software Foundation, Inc. * .\" * .\" Permission is hereby granted, free of charge, to any person obtaining a * @@ -27,8 +27,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: curs_get_wch.3x,v 1.31 2023/12/23 16:35:10 tom Exp $ -.TH curs_get_wch 3X 2023-12-23 "ncurses 6.4" "Library calls" +.\" $Id: curs_get_wch.3x,v 1.36 2024/03/23 20:00:03 tom Exp $ +.TH curs_get_wch 3X 2024-03-23 "ncurses 6.4" "Library calls" .ie \n(.g \{\ .ds `` \(lq .ds '' \(rq @@ -63,133 +63,198 @@ get (or push back) a wide character from \fIcurses\fR terminal keyboard \fBint unget_wch(const wchar_t \fIwch\fP); .fi .SH DESCRIPTION -.SS wget_wch -The -\fBget_wch\fP, -\fBwget_wch\fP, -\fBmvget_wch\fP, and -\fBmvwget_wch\fP -functions read a character -from the terminal associated with the current or specified window. -In no-delay mode, -if no input is waiting, the value \fBERR\fP is returned. -In delay mode, -the program waits until the system passes text through to the program. -Depending on the setting of \fBcbreak\fP, -this is after one character (cbreak mode), -or after the first newline (nocbreak mode). -In half-delay mode, -the program waits until the user types a character or the specified -timeout interval has elapsed. +.SS "Reading Characters" +.B \%wget_wch +gathers a key stroke +.I wch +from the terminal keyboard associated with a +.I curses +window +.IR win , +returning +.B OK +if a wide character is read, +.B \%KEY_CODE_YES +if a function key is read, +and +.B ERR +if no key event is available. +\fB\%ncurses\fP(3X) describes the variants of this function. .PP -Unless \fBnoecho\fP has been set, -these routines echo the character into the designated window. +When input is pending, +.B \%wget_wch +stores an integer +identifying the key stroke in +.IR wch ; +for alphanumeric and punctuation keys, +this value corresponds to the character encoding used by the terminal. +Use of the control key as a modifier often results in a distinct code. +The behavior of other keys depends on whether +.I win +is in keypad mode; +see subsections \*(``Keypad Mode\*('' and \*(``Predefined Key Codes\*('' +in \fB\%getch\fP(3X). .PP -If the window is not a pad and has been moved or modified since the -last call to \fBwrefresh\fP, -\fBwrefresh\fP will be called before another character is read. +If no input is pending, +then if the no-delay flag is set in the window +(see \fB\%nodelay\fP(3X)), +the function returns +.BR ERR ; +otherwise, +.I curses +waits until the terminal has input. +If \fB\%cbreak\fP(3X) +has been called, +this happens after one character is read. +If \fB\%nocbreak\fP(3X) +has been called, +it occurs when the next newline is read. +If \fB\%halfdelay\fP(3X) +has been called, +.I curses +waits until a character is typed or the specified delay elapses. .PP -If \fBkeypad\fP is enabled, -these functions respond to -the pressing of a function key by setting the object pointed to by -\fIwch\fP -to the keycode assigned to the function key, -and returning \fBKEY_CODE_YES\fP. -If a character (such as escape) that could be the -beginning of a function key is received, curses sets a timer. -If the remainder -of the sequence does arrive within the designated time, curses passes through -the character; otherwise, curses returns the function key value. -For this -reason, many terminals experience a delay between the time a user presses -the escape key and the time the escape is returned to the program. -.PP -The keycodes returned by these functions are the same as those -returned by \fBwgetch\fP: +If \fB\%echo\fP(3X) has been called, +and the window is not a pad, +.I curses +writes +.I wch +to the window +(at the cursor position) +per the following rules. +.bP +If +.I wch +matches the terminal's erase character, +the cursor moves leftward one position +and the new position is erased +as if \fB\%wmove\fP(3X) and then \fB\%wdelch\fP(3X) were called. +When the window's keypad mode is enabled +(see below), +.B \%KEY_LEFT +and +.B \%KEY_BACKSPACE +are handled the same way. .bP -The predefined function -keys are listed in \fB<curses.h>\fP as macros with values outside the range -of 8-bit characters. -Their names begin with \fBKEY_\fP. +.I curses +writes any other +.I wch +to the window, +as with \fB\%wecho_wchar\fP(3X). .bP -Other (user-defined) function keys -which may be defined using \fBdefine_key\fP(3X) have no names, -but also are expected to have values outside the range of 8-bit characters. -.SS unget_wch -The -\fBunget_wch\fP -function pushes the wide character -\fIwch\fP -back onto the head of the input queue, so the wide character -is returned by the next call to -\fBget_wch\fP. -The pushback of -one character is guaranteed. -If the program calls -\fBunget_wch\fP -too many times without an intervening call to -\fBget_wch\fP, -the operation may fail. +If the window has been moved or modified since the last call to +\fB\%wrefresh\fP(3X), +.I curses +calls +.BR \%wrefresh . .PP -Unlike \fBungetch\fP and \fBwgetch\fP, -\fBunget_wch\fP cannot distinguish special characters -returned by \fBwget_wch\fP from ordinary characters. -An application can push special keys -which it may read via \fBwget_wch\fP -by checking for the \fBKEY_CODE_YES\fP result, -and using \fBungetch\fP for those special keys. +If +.I wch +is a carriage return and \fBnl\fP(3X) has been called, +.B \%wgetch +stores the the character code for newline +(line feed) +in +.I wch +instead. +.SS "Ungetting Characters" +.B \%unget_wch +places +.I wch +into the input queue to be returned by the next call to +.BR \%wget_wch . +A single input queue serves all windows. .SH RETURN VALUE -When -\fBget_wch\fP, -\fBwget_wch\fP, -\fBmvget_wch\fP, and -\fBmvwget_wch\fP -functions successfully -report the pressing of a function key, they return -\fBKEY_CODE_YES\fP. -When they successfully report a wide character, they return -\fBOK\fP. -Otherwise, they return -\fBERR\fP. -.PP -Upon successful completion, -\fBunget_wch\fP +.B \%wget_wch returns -\fBOK\fP. -Otherwise, the function returns -\fBERR\fP. +.B OK +when it reads a wide character and +.B \%KEY_CODE_YES +when it reads a function key code. +It returns +.B ERR +if +.bP +the +.I \%WINDOW +pointer is +.BR NULL , +or +.bP +its timeout expires without any data arriving, +or +.bP +execution was interrupted by a signal, +in which case +.B \%errno +is set to +.BR \%EINTR . .PP -Functions with a \*(``mv\*('' prefix first perform a cursor movement using -\fBwmove\fP, and return an error if the position is outside the window, -or if the window pointer is null. -.SH NOTES -Applications should not define the escape key by itself as a single-character -function. +Functions with a \*(``mv\*('' prefix first perform cursor movement using +\fB\%wmove\fP(3X) and fail if the position is outside the window, +or +(for \*(``mvw\*('' functions) +if the +.I win +parameter is a null pointer. .PP -When using -\fBget_wch\fP, -\fBwget_wch\fP, -\fBmvget_wch\fP, or -\fBmvwget_wch\fP, applications should -not use -\fBnocbreak\fP -mode and -\fBecho\fP -mode -at the same time. -Depending on the state of the tty driver when each character -is typed, the program may produce undesirable results. +.B \%unget_wch +returns +.B OK +on success and +.B ERR +if there is no more room in the input queue. +.SH NOTES +See the \*(``NOTES\*('' section of \fB\%wgetch\fP(3X). .PP All of these functions except -\fB\%wget_wch\fP and -\fB\%unget_wch\fP +.B \%wget_wch +and +.B \%unget_wch may be implemented as macros. +.PP +Unlike \fB\%wgetch\fP(3X), +.B \%wget_wch +and its variants store the value of the input character in an additional +.I wch +parameter instead of the return value. +.PP +Unlike +.BR \%ungetch , +.B \%unget_wch +cannot distinguish function key codes +.B \%wget_wch +from conventional character codes. +An application can overcome this limitation by pushing function key +codes with +.B \%ungetch +and subsequently checking the return value of +.B \%wget_wch +for a match with +.BR \%KEY_CODE_YES . +.SH EXTENSIONS +See the \*(``EXTENSIONS\*('' section of \fB\%wgetch\fP(3X). .SH PORTABILITY -These functions are described in the XSI Curses standard, Issue 4. +Applications employing +.I \%ncurses +extensions should condition their use on the visibility of the +.B \%NCURSES_VERSION +preprocessor macro. +.PP +X/Open Curses, Issue 4, describes these functions. +It specifies no error conditions for them. +.PP +See the \*(``PORTABILITY\*('' section of \fB\%wgetch\fP(3X) regarding +the interaction of +.B \%wget_wch +with signal handlers. .SH SEE ALSO \fB\%curses\fP(3X), -\fB\%curs_getch\fP(3X), +\fB\%curs_add_wch\fP(3X), \fB\%curs_inopts\fP(3X), -\fB\%curs_ins_wch\fP(3X), \fB\%curs_move\fP(3X), \fB\%curs_refresh\fP(3X) +.PP +\fB\%curs_getch\fP(3X) describes comparable functions of the +.I \%ncurses +library in its non-wide-character configuration. diff --git a/upstream/mageia-cauldron/man3/curs_get_wstr.3x b/upstream/mageia-cauldron/man3/curs_get_wstr.3x index 6d7a3c3e..97f443f0 100644 --- a/upstream/mageia-cauldron/man3/curs_get_wstr.3x +++ b/upstream/mageia-cauldron/man3/curs_get_wstr.3x @@ -1,5 +1,5 @@ .\"*************************************************************************** -.\" Copyright 2018-2022,2023 Thomas E. Dickey * +.\" Copyright 2018-2023,2024 Thomas E. Dickey * .\" Copyright 2002-2012,2017 Free Software Foundation, Inc. * .\" * .\" Permission is hereby granted, free of charge, to any person obtaining a * @@ -27,8 +27,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: curs_get_wstr.3x,v 1.42 2023/12/16 20:32:22 tom Exp $ -.TH curs_get_wstr 3X 2023-12-16 "ncurses 6.4" "Library calls" +.\" $Id: curs_get_wstr.3x,v 1.44 2024/03/16 15:35:01 tom Exp $ +.TH curs_get_wstr 3X 2024-03-16 "ncurses 6.4" "Library calls" .ie \n(.g \{\ .ds `` \(lq .ds '' \(rq diff --git a/upstream/mageia-cauldron/man3/curs_getcchar.3x b/upstream/mageia-cauldron/man3/curs_getcchar.3x index 760b85bd..d3984d76 100644 --- a/upstream/mageia-cauldron/man3/curs_getcchar.3x +++ b/upstream/mageia-cauldron/man3/curs_getcchar.3x @@ -1,5 +1,5 @@ .\"*************************************************************************** -.\" Copyright 2019-2021,2023 Thomas E. Dickey * +.\" Copyright 2019-2023,2024 Thomas E. Dickey * .\" Copyright 2001-2015,2017 Free Software Foundation, Inc. * .\" * .\" Permission is hereby granted, free of charge, to any person obtaining a * @@ -27,8 +27,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: curs_getcchar.3x,v 1.43 2023/12/16 21:07:24 tom Exp $ -.TH curs_getcchar 3X 2023-12-16 "ncurses 6.4" "Library calls" +.\" $Id: curs_getcchar.3x,v 1.45 2024/03/16 15:35:01 tom Exp $ +.TH curs_getcchar 3X 2024-03-16 "ncurses 6.4" "Library calls" .de bP .ie n .IP \(bu 4 .el .IP \(bu 2 diff --git a/upstream/mageia-cauldron/man3/curs_getch.3x b/upstream/mageia-cauldron/man3/curs_getch.3x index fed7fa70..af510d01 100644 --- a/upstream/mageia-cauldron/man3/curs_getch.3x +++ b/upstream/mageia-cauldron/man3/curs_getch.3x @@ -28,19 +28,24 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: curs_getch.3x,v 1.78 2024/02/17 19:27:03 tom Exp $ -.TH curs_getch 3X 2024-02-17 "ncurses 6.4" "Library calls" +.\" $Id: curs_getch.3x,v 1.83 2024/03/23 20:38:57 tom Exp $ +.TH curs_getch 3X 2024-03-23 "ncurses 6.4" "Library calls" .ie \n(.g \{\ .ds `` \(lq .ds '' \(rq +.ds ^ \(ha .\} .el \{\ .ie t .ds `` `` .el .ds `` "" .ie t .ds '' '' .el .ds '' "" +.ds ^ ^ .\} . +.ie \n(.g .ds : \: +.el .ds : \" empty +. .de bP .ie n .IP \(bu 4 .el .IP \(bu 2 @@ -64,318 +69,528 @@ get (or push back) characters from \fIcurses\fR terminal keyboard .PP .B int ungetch(int \fIch\fP); .PP +.\" XXX: Move has_key into its own page like define_key and key_defined? \fI/* extension */\fP .B int has_key(int \fIch\fP); .fi .SH DESCRIPTION .SS "Reading Characters" -The \fBgetch\fP, \fBwgetch\fP, \fBmvgetch\fP and \fBmvwgetch\fP, routines read -a character from the window. -In no-delay mode, if no input is waiting, the value \fBERR\fP is returned. -In delay mode, the program waits until the system -passes text through to the program. -Depending on the setting of \fBcbreak\fP, -this is after one character (cbreak mode), -or after the first newline (nocbreak mode). -In half-delay mode, -the program waits until a character is typed or the -specified timeout has been reached. +.B \%wgetch +gathers a key stroke from the terminal keyboard associated with a +.I curses +window +.IR win . +\fB\%ncurses\fP(3X) describes the variants of this function. .PP -If \fBecho\fP is enabled, and the window is not a pad, -then the character will also be echoed into the -designated window according to the following rules: -.bP -If the character is the current erase character, left arrow, or backspace, -the cursor is moved one space to the left and that screen position is erased -as if \fBdelch\fP had been called. +When input is pending, +.B \%wgetch +returns an integer identifying the key stroke; +for alphanumeric and punctuation keys, +this value corresponds to the character encoding used by the terminal. +Use of the control key as a modifier often results in a distinct code. +The behavior of other keys depends on whether +.I win +is in keypad mode; +see subsection \*(``Keypad Mode\*('' below. +.PP +If no input is pending, +then if the no-delay flag is set in the window +(see \fB\%nodelay\fP(3X)), +the function returns +.BR ERR ; +otherwise, +.I curses +waits until the terminal has input. +If \fB\%cbreak\fP(3X) +has been called, +this happens after one character is read. +If \fB\%nocbreak\fP(3X) +has been called, +it occurs when the next newline is read. +If \fB\%halfdelay\fP(3X) +has been called, +.I curses +waits until a character is typed or the specified delay elapses. +.PP +If \fB\%echo\fP(3X) has been called, +and the window is not a pad, +.I curses +writes the returned character +.I ch +to the window +(at the cursor position) +per the following rules. .bP -If the character value is any other \fBKEY_\fP define, the user is alerted -with a \fBbeep\fP call. +If +.I ch +matches the terminal's erase character, +the cursor moves leftward one position +and the new position is erased +as if \fB\%wmove\fP(3X) and then \fB\%wdelch\fP(3X) were called. +When the window's keypad mode is enabled +(see below), +.B \%KEY_LEFT +and +.B \%KEY_BACKSPACE +are handled the same way. .bP -If the character is a carriage-return, -and if \fBnl\fP is enabled, -it is translated to a line-feed after echoing. +.I curses +writes any other +.I ch +to the window, +as with \fB\%wechochar\fP(3X). .bP -Otherwise the character is simply output to the screen. +If the window has been moved or modified since the last call to +\fB\%wrefresh\fP(3X), +.I curses +calls +.BR \%wrefresh . .PP -If the window is not a pad, and it has been moved or modified since the last -call to \fBwrefresh\fP, \fBwrefresh\fP will be called before another character -is read. +If +.I ch +is a carriage return and \fBnl\fP(3X) has been called, +.B \%wgetch +returns the character code for newline +(line feed) +instead. .SS "Keypad Mode" -If \fBkeypad\fP is \fBTRUE\fP, and a function key is pressed, the token for -that function key is returned instead of the raw characters: +To +.IR curses , +key strokes not from the alphabetic section of the keyboard +(those corresponding to the ECMA-6 character set\(emsee +\fIascii\fP(7)\(emoptionally modified by either the control or shift +keys) +are treated as +.I function +keys. +(In +.IR curses , +the term \*(``function key\*('' includes but is not limited to keycaps +engraved with \*(``F1\*('', +\*(``PF1\*('', +and so on.) +If the window is in keypad mode, +these produce a numeric code corresponding to the +.B KEY_ +symbols listed in subsection \*(``Predefined Key Codes\*('' below; +otherwise, +they transmit a sequence of codes typically starting with the escape +character, +and which must be collected with multiple +.B \%wgetch +calls. .bP -The predefined function -keys are listed in \fB<curses.h>\fP as macros with values outside the range -of 8-bit characters. -Their names begin with \fBKEY_\fP. +The +.I \%curses.h +header file declares many +.I "predefined function keys" +whose names begin with +.BR KEY_ ; +these object-like macros have values outside the range of eight-bit +character codes. .bP -Other (user-defined) function keys which may be defined -using \fBdefine_key\fP(3X) -have no names, but also are expected to have values outside the range of -8-bit characters. +In +.IR \%ncurses , +.I "user-defined function keys" +are configured with \fBdefine_key\fP(3X); +they have no names, +but are also expected to have values outside the range of eight-bit +codes. .PP -Thus, a variable -intended to hold the return value of a function key must be of short size or -larger. +A variable intended to hold a function key code must thus be of type +.I short +or larger. .PP -When a character that could be the beginning of a function key is received -(which, on modern terminals, means an escape character), -\fBcurses\fP sets a timer. -If the remainder of the sequence does not come in within the designated -time, the character is passed through; -otherwise, the function key value is returned. -For this reason, many terminals experience a delay between the time -a user presses the escape key and the escape is returned to the program. -.PP -In \fI\%ncurses\fP, the timer normally expires after -the value in \fBESCDELAY\fP (see \fBcurs_variables\fP(3X)). -If \fBnotimeout\fP is \fBTRUE\fP, the timer does not expire; -it is an infinite (or very large) value. -Because function keys usually begin with an escape character, -the terminal may appear to hang in notimeout mode after pressing the escape key -until another key is pressed. +Most terminals one encounters follow the ECMA-48 standard insofar as +their function keys produce character sequences prefixed with the +escape character ESC. +This fact implies that +.I curses +cannot know whether the terminal has sent an ESC key stroke or the +beginning of a function key's character sequence without waiting to see +if, +and how soon, +further input arrives. +When +.I curses +reads such an ambiguous character, +it sets a timer. +If the remainder of the sequence does not arrive within the designated +time, +.B \%wgetch +returns the prefix character; +otherwise, +it returns the function key code corresponding to the unique sequence +defined by the terminal. +Consequently, +a user of a +.I curses +application may experience a delay after pressing ESC while +.I curses +disambiguates the input. +See section \*(``EXTENSIONS\*('' below. +If the window is in \*(``no time-out\*('' mode, +the timer does not expire; +it is an infinite +(or very large) +value. +See \fB\%notimeout\fP(3X). +Because function key sequences usually begin with an escape character, +the terminal may appear to hang in no time-out mode after the user has +pressed ESC. +Generally, +further typing \*(``awakens\*('' +.IR curses . .SS "Ungetting Characters" -The \fBungetch\fP routine places \fIch\fP back onto the input queue to be -returned by the next call to \fBwgetch\fP. -There is just one input queue for all windows. +.B \%ungetch +places +.I ch +into the input queue to be returned by the next call to +.BR \%wgetch . +A single input queue serves all windows. .SS "Predefined Key Codes" -The following special keys are defined in \fB<curses.h>\fP. +The header file +.I \%curses.h +defines the following function key codes. .bP -Except for the special case \fBKEY_RESIZE\fP, -it is necessary to enable \fBkeypad\fP for \fBgetch\fP to return these codes. +Except for the special case of +.BR \%KEY_RESIZE , +a window's keypad mode must be enabled for +.B \%wgetch +to read these codes from it. .bP Not all of these are necessarily supported on any particular terminal. .bP -The naming convention may seem obscure, with some apparent -misspellings (such as \*(``RSUME\*('' for \*(``resume\*(''). -The names correspond to the long terminfo capability names for the keys, -and were defined long ago, in the 1980s. +The naming convention may seem obscure, +with some apparent misspellings +(such as \*(``RSUME\*('' for \*(``resume\*(''); +The names correspond to the +.I \%term\%info +capability names for the keys, +and were standardized before the IBM PC/AT keyboard layout achieved a +dominant position in industry. .PP .RS +.\" XXX: Move this list into ncurses(3X), rather than duplicating it in +.\" get_wch(3X) or having that page cross reference this one? .TS -tab(/) ; -l l . -\fBName\fP/\fBKey\fP \fBname\fP -_ -KEY_BREAK/Break key -KEY_DOWN/The four arrow keys ... -KEY_UP -KEY_LEFT -KEY_RIGHT -KEY_HOME/Home key (upward+left arrow) -KEY_BACKSPACE/Backspace -KEY_F0/T{ -Function keys; space for 64 keys is reserved. +Lb Lb +Lb Lx. +Symbol Key name += +KEY_BREAK Break key +KEY_DOWN Arrow keys +KEY_UP \^ +KEY_LEFT \^ +KEY_RIGHT \^ +KEY_HOME Home key (upward+left arrow) +KEY_BACKSPACE Backspace +KEY_F0 T{ +Function keys; space for 64 keys is reserved T} -KEY_F(\fIn\fP)/T{ -For 0 \(<= \fIn\fP \(<= 63 +KEY_F(\fIn\fP) T{ +Function key \fIn\fP where 0 \(<= \fIn\fP \(<= 63 T} -KEY_DL/Delete line -KEY_IL/Insert line -KEY_DC/Delete character -KEY_IC/Insert char or enter insert mode -KEY_EIC/Exit insert char mode -KEY_CLEAR/Clear screen -KEY_EOS/Clear to end of screen -KEY_EOL/Clear to end of line -KEY_SF/Scroll 1 line forward -KEY_SR/Scroll 1 line backward (reverse) -KEY_NPAGE/Next page -KEY_PPAGE/Previous page -KEY_STAB/Set tab -KEY_CTAB/Clear tab -KEY_CATAB/Clear all tabs -KEY_ENTER/Enter or send -KEY_SRESET/Soft (partial) reset -KEY_RESET/Reset or hard reset -KEY_PRINT/Print or copy -KEY_LL/Home down or bottom (lower left) -KEY_A1/Upper left of keypad -KEY_A3/Upper right of keypad -KEY_B2/Center of keypad -KEY_C1/Lower left of keypad -KEY_C3/Lower right of keypad -KEY_BTAB/Back tab key -KEY_BEG/Beg(inning) key -KEY_CANCEL/Cancel key -KEY_CLOSE/Close key -KEY_COMMAND/Cmd (command) key -KEY_COPY/Copy key -KEY_CREATE/Create key -KEY_END/End key -KEY_EXIT/Exit key -KEY_FIND/Find key -KEY_HELP/Help key -KEY_MARK/Mark key -KEY_MESSAGE/Message key -KEY_MOUSE/Mouse event occurred -KEY_MOVE/Move key -KEY_NEXT/Next object key -KEY_OPEN/Open key -KEY_OPTIONS/Options key -KEY_PREVIOUS/Previous object key -KEY_REDO/Redo key -KEY_REFERENCE/Ref(erence) key -KEY_REFRESH/Refresh key -KEY_REPLACE/Replace key -KEY_RESIZE/Screen resized -KEY_RESTART/Restart key -KEY_RESUME/Resume key -KEY_SAVE/Save key -KEY_SBEG/Shifted beginning key -KEY_SCANCEL/Shifted cancel key -KEY_SCOMMAND/Shifted command key -KEY_SCOPY/Shifted copy key -KEY_SCREATE/Shifted create key -KEY_SDC/Shifted delete char key -KEY_SDL/Shifted delete line key -KEY_SELECT/Select key -KEY_SEND/Shifted end key -KEY_SEOL/Shifted clear line key -KEY_SEXIT/Shifted exit key -KEY_SFIND/Shifted find key -KEY_SHELP/Shifted help key -KEY_SHOME/Shifted home key -KEY_SIC/Shifted insert key -KEY_SLEFT/Shifted left arrow key -KEY_SMESSAGE/Shifted message key -KEY_SMOVE/Shifted move key -KEY_SNEXT/Shifted next key -KEY_SOPTIONS/Shifted options key -KEY_SPREVIOUS/Shifted prev key -KEY_SPRINT/Shifted print key -KEY_SREDO/Shifted redo key -KEY_SREPLACE/Shifted replace key -KEY_SRIGHT/Shifted right arrow key -KEY_SRSUME/Shifted resume key -KEY_SSAVE/Shifted save key -KEY_SSUSPEND/Shifted suspend key -KEY_SUNDO/Shifted undo key -KEY_SUSPEND/Suspend key -KEY_UNDO/Undo key +KEY_DL Delete line +KEY_IL Insert line +KEY_DC Delete character +KEY_IC Insert character/Enter insert mode +KEY_EIC Exit insert character mode +KEY_CLEAR Clear screen +KEY_EOS Clear to end of screen +KEY_EOL Clear to end of line +KEY_SF Scroll one line forward +KEY_SR Scroll one line backward (reverse) +KEY_NPAGE Next page/Page up +KEY_PPAGE Previous page/Page down +KEY_STAB Set tab +KEY_CTAB Clear tab +KEY_CATAB Clear all tabs +KEY_ENTER Enter/Send +KEY_SRESET Soft (partial) reset +KEY_RESET (Hard) reset +KEY_PRINT Print/Copy +KEY_LL Home down/Bottom (lower left) +KEY_A1 Upper left of keypad +KEY_A3 Upper right of keypad +KEY_B2 Center of keypad +KEY_C1 Lower left of keypad +KEY_C3 Lower right of keypad +KEY_BTAB Back tab key +KEY_BEG Beg(inning) key +KEY_CANCEL Cancel key +KEY_CLOSE Close key +KEY_COMMAND Cmd (command) key +KEY_COPY Copy key +KEY_CREATE Create key +KEY_END End key +KEY_EXIT Exit key +KEY_FIND Find key +KEY_HELP Help key +KEY_MARK Mark key +KEY_MESSAGE Message key +KEY_MOUSE Mouse event occurred +KEY_MOVE Move key +KEY_NEXT Next object key +KEY_OPEN Open key +KEY_OPTIONS Options key +KEY_PREVIOUS Previous object key +KEY_REDO Redo key +KEY_REFERENCE Ref(erence) key +KEY_REFRESH Refresh key +KEY_REPLACE Replace key +KEY_RESIZE Screen resized +KEY_RESTART Restart key +KEY_RESUME Resume key +KEY_SAVE Save key +KEY_SELECT Select key +KEY_SUSPEND Suspend key +KEY_UNDO Undo key +_ +KEY_SBEG Shifted beginning key +KEY_SCANCEL Shifted cancel key +KEY_SCOMMAND Shifted command key +KEY_SCOPY Shifted copy key +KEY_SCREATE Shifted create key +KEY_SDC Shifted delete character key +KEY_SDL Shifted delete line key +KEY_SEND Shifted end key +KEY_SEOL Shifted clear line key +KEY_SEXIT Shifted exit key +KEY_SFIND Shifted find key +KEY_SHELP Shifted help key +KEY_SHOME Shifted home key +KEY_SIC Shifted insert key +KEY_SLEFT Shifted left arrow key +KEY_SMESSAGE Shifted message key +KEY_SMOVE Shifted move key +KEY_SNEXT Shifted next object key +KEY_SOPTIONS Shifted options key +KEY_SPREVIOUS Shifted previous object key +KEY_SPRINT Shifted print key +KEY_SREDO Shifted redo key +KEY_SREPLACE Shifted replace key +KEY_SRIGHT Shifted right arrow key +KEY_SRSUME Shifted resume key +KEY_SSAVE Shifted save key +KEY_SSUSPEND Shifted suspend key +KEY_SUNDO Shifted undo key .TE .RE .PP -Keypad is arranged like this: +The keypad is arranged as follows. .PP .RS .TS -allbox tab(/) ; -c c c . -\fBA1\fP/\fBup\fP/\fBA3\fP -\fBleft\fP/\fBB2\fP/\fBright\fP -\fBC1\fP/\fBdown\fP/\fBC3\fP +allbox center; +C C C. +A1 up A3 +left B2 right +C1 down C3 .TE .RE .sp -A few of these predefined values do \fInot\fP correspond to a real key: +Two of these symbols do +.I not +correspond to a real key. .bP -.B KEY_RESIZE -is returned when the \fBSIGWINCH\fP signal has been detected -(see \fBinitscr\fP(3X) and \fBresizeterm\fP(3X)). -This code is returned whether or not \fBkeypad\fP has been enabled. +.B \%wgetch +returns +.B \%KEY_RESIZE +(even if the window's keypad mode is disabled) +when +.I \%ncurses +detects the +.B \%SIGWINCH +signal; +see \fBinitscr\fP(3X) and \fBresizeterm\fP(3X). .bP -.B KEY_MOUSE -is returned for mouse-events (see \fBcurs_mouse\fP(3X)). -This code relies upon whether or not \fBkeypad\fP(3X) has been enabled, -because -(e.g., -with \fBxterm\fP(1) mouse prototocol) -\fI\%ncurses\fP must read escape sequences, -just like a function key. +.B \%wgetch +returns +.B \%KEY_MOUSE +to indicate that a mouse event is pending collection; +see \fBcurs_mouse\fP(3X). +Receipt of this code requires a window's keypad mode to be enabled, +because to interpret mouse input +(as with with \fIxterm\fP(1)'s mouse prototocol), +.I \%ncurses +must read an escape sequence, +as with a function key. .SS "Testing Key Codes" -The \fBhas_key\fP routine takes a key-code value from the above list, and -returns \fBTRUE\fP or \fBFALSE\fP according to whether -the current terminal type recognizes a key with that value. -.PP -The library also supports these extensions: -.RS 3 -.TP 5 -.B define_key -defines a key-code for a given string (see \fBdefine_key\fP(3X)). -.TP 5 -.B key_defined -checks if there is a key-code defined for a given -string (see \fBkey_defined\fP(3X)). -.RE +In +.IR \%ncurses , +.B \%has_key +takes a key code value from the above list, +and returns a Boolean value indicating the terminal's recognition of it. +See also +\fBdefine_key\fP(3X) and \fBkey_defined\fP(3X). .SH RETURN VALUE -All routines return the integer \fBERR\fP upon failure and an integer value -other than \fBERR\fP (\fBOK\fP in the case of \fBungetch\fP) upon successful -completion. -.RS 3 -.TP 5 -\fBungetch\fP -returns \fBERR\fP -if there is no more room in the FIFO. -.TP -\fBwgetch\fP -returns \fBERR\fP -.RS +.B \%wgetch +returns +.B ERR +if .bP -if the window pointer is null, or +the +.I \%WINDOW +pointer is +.BR NULL , +or .bP -if its timeout expires without having any data, or +its timeout expires without any data arriving, +or .bP -if the execution was interrupted by a signal (\fBerrno\fP will be set to -\fBEINTR\fP). -.RE -.RE +execution was interrupted by a signal, +in which case +.B \%errno +is set to +.BR \%EINTR . +.PP +Functions with a \*(``mv\*('' prefix first perform cursor movement using +\fB\%wmove\fP(3X) and fail if the position is outside the window, +or +(for \*(``mvw\*('' functions) +if the +.I win +parameter is a null pointer. +.PP +.B \%ungetch +returns +.B OK +on success and +.B ERR +if there is no more room in the input queue. .PP -Functions with a \*(``mv\*('' prefix first perform a cursor movement using -\fBwmove\fP, and return an error if the position is outside the window, -or if the window pointer is null. +.B \%has_key +returns +.B TRUE +or +.BR FALSE . .SH NOTES -Use of the escape key by a programmer for a single character function is -discouraged, as it will cause a delay of up to one second while the -keypad code looks for a following function-key sequence. +.I curses +discourages assignment of the ESC key to a discrete function by the +programmer because the library requires a delay while it awaits the +potential remainder of a terminal escape sequence. .PP -Some keys may be the same as commonly used control -keys, e.g., -\fBKEY_ENTER\fP versus control/M, -\fBKEY_BACKSPACE\fP versus control/H. -Some curses implementations may differ according to whether they -treat these control keys specially (and ignore the terminfo), or -use the terminfo definitions. -\fI\%ncurses\fP uses the terminfo definition. -If it says that \fBKEY_ENTER\fP is control/M, -\fBgetch\fP will return \fBKEY_ENTER\fP -when you press control/M. +Some key strokes are indistinguishable from control characters; +for example, +.B \%KEY_ENTER +may be the same as +.BR \*^M , +.\" as with att630 or pccon+keys +and +.B \%KEY_BACKSPACE +may be the same as +.B \*^H +.\" as with att505 or vt52-basic +or +.BR \*^? . +.\" as with pccon+keys or vt320 +Consult the terminal's +.I \%term\%info +entry to determine whether this is the case; +see \fB\%infocmp\fP(1). +Some +.I curses +implementations, +including +.IR \%ncurses , +honor the +.I \%term\%info +key definitions; +others treat such control characters specially. .PP -Generally, \fBKEY_ENTER\fP denotes the character(s) sent by the \fIEnter\fP -key on the numeric keypad: +.I curses +distinguishes the Enter keys in the alphabetic and numeric keypad +sections of a keyboard because (most) terminals do. +.B \%KEY_ENTER +refers to the key on the (numeric) keypad and, +like other function keys, +is reliably recognized only if the window's keypad mode is enabled. .bP -the terminal description lists the most useful keys, +The +.I \%term\%info +.B \%key_enter +.RB ( kent ) +capability describes the character (sequence) sent by the terminal's +keypad Enter key. .bP -the \fIEnter\fP key on the regular keyboard is already handled by -the standard ASCII characters for carriage-return and line-feed, +\*(``Enter or send\*('' is X/Open Curses's description of this key. +.PP +.I curses +treats the Enter or Return key in the +.I alphabetic +section of the keyboard differently. .bP -depending on whether \fBnl\fP or \fBnonl\fP was called, -pressing \*(``Enter\*('' on the regular keyboard -may return either a carriage-return or line-feed, and finally +It usually produces a control code for carriage return +.RB ( \*^M ) +or line feed +.RB ( \*^J ). .bP -\*(``Enter or send\*('' is the standard description for this key. +Depending on the terminal mode +(raw, +cbreak, +or +\*(``cooked\*(''), +and whether \fB\%nl\fP(3X) or \fB\%nonl\fP(3X) has been called, +.B \%wgetch +may return either a carriage return or line feed upon an Enter or Return +key stroke. .PP -When using \fBgetch\fP, \fBwgetch\fP, \fBmvgetch\fP, or -\fBmvwgetch\fP, nocbreak mode (\fBnocbreak\fP) and echo mode -(\fBecho\fP) should not be used at the same time. -Depending on the -state of the tty driver when each character is typed, the program may -produce undesirable results. +Use of +.B \%wgetch +with \fB\%echo\fP(3X) and neither \fB\%cbreak\fP(3X) nor \fB\%raw\fP(3X) +is not well-defined. .PP -Note that \fBgetch\fP, \fBmvgetch\fP, and \fBmvwgetch\fP may be macros. +Historically, +the list of key code macros above was influenced by the +function-key-rich keyboard of the AT&T 7300 +(also known variously as the \*(``3B1\*('', \*(``Safari 4\*('', and +\*(``UNIX PC\*(''), +a 1985 machine. +Today's computer keyboards are based on the IBM PC/AT keyboard and tend +to have fewer. +A +.I curses +application can expect such a keyboard to transmit key codes +.BR \%KEY_UP , +.BR \%KEY_DOWN , +.BR \%KEY_LEFT , +.BR \%KEY_RIGHT , +.BR \%KEY_HOME , +.BR \%KEY_END , +.B \%KEY_PPAGE +(Page Up), +.B \%KEY_NPAGE +(Page Down), +.B \%KEY_IC +(Insert), +.B \%KEY_DC +(Delete), +and +.BI \%KEY_F( n ) +for 1 \(<= +.I n +\(<= 12. .PP -Historically, the set of keypad macros was largely defined by the extremely -function-key-rich keyboard of the AT&T 7300, aka 3B1, aka Safari 4. -Modern -personal computers usually have only a small subset of these. -IBM PC-style -consoles typically support little more than \fBKEY_UP\fP, \fBKEY_DOWN\fP, -\fBKEY_LEFT\fP, \fBKEY_RIGHT\fP, \fBKEY_HOME\fP, \fBKEY_END\fP, -\fBKEY_NPAGE\fP, \fBKEY_PPAGE\fP, and function keys 1 through 12. -The Ins key -is usually mapped to \fBKEY_IC\fP. +.BR \%getch , +.BR \%mvgetch , +and +.B \%mvwgetch +may be implemented as macros. .SH EXTENSIONS +In +.IR \%ncurses , +when a window's \*(``no time-out\*('' mode is +.I not +set, +the +.B \%ESCDELAY +variable configures the duration of the timer used to disambiguate a +function key character sequence from a series of key strokes beginning +with ESC typed by the user; +see +\fB\%curs_variables\fP(3X). +.PP \fB\%has_key\fP was designed for \fB\%ncurses\fP(3X), and is not found in SVr4 .IR curses , @@ -389,32 +604,50 @@ extensions should condition their use on the visibility of the .B \%NCURSES_VERSION preprocessor macro. .PP -X/Open Curses, Issue 4, Version 2, describes +X/Open Curses, Issue 4, describes \fB\%getch\fP, \fB\%wgetch\fP, \fB\%mvgetch\fP, \fB\%mvwgetch\fP, and \fB\%ungetch\fP. -They read single-byte characters only. -The standard specifies that they return \fBERR\fP on failure, -but describes no failure conditions. +It specifies no error conditions for them. +.PP +.B \%wgetch +reads only single-byte characters. .PP The echo behavior of these functions on input of .B KEY_ or backspace characters was not specified in the SVr4 documentation. This description is adapted from X/Open Curses. .PP -The behavior of \fBgetch\fP and friends in the presence of signal -handlers is unspecified in the SVr4 documentation and X/Open Curses. -Under historical curses implementations, +The behavior of +.B \%wgetch +in the presence of signal handlers is unspecified in the SVr4 +documentation and X/Open Curses. +In historical +.I curses +implementations, it varied depending on whether the operating system's dispatch of a -signal to a handler interrupts a \fBread\fP(2) call in progress or not, +signal to a handler interrupts a \fIread\fP(2) call in progress or not, and also (in some implementations) whether an input timeout or non-blocking mode has been set. +Programmers concerned about portability should be prepared for either of +two cases: +(a) signal receipt does not interrupt +.BR \%wgetch ; +or +(b) signal receipt interrupts +.B \%wgetch +and causes it to return +.B ERR +with +.B \%errno +set to +.BR \%EINTR . .PP -.B KEY_MOUSE +.B \%KEY_MOUSE is mentioned in X/Open Curses, along with a few related .I \%term\%info @@ -424,31 +657,41 @@ The implementation in .I \%ncurses is an extension. .PP -.B KEY_RESIZE -is an extension first implemented for -.I \%ncurses. +.B \%KEY_RESIZE +and +.B \%has_key +are extensions first implemented for +.IR \%ncurses . +By 2022, +.I \%PDCurses +.\" https://web.archive.org/web/20220117232009/https://pdcurses.org/docs/MANUAL.html +and NetBSD .I curses -later added this extension. -.PP -Programmers concerned about portability should be prepared for either of two -cases: (a) signal receipt does not interrupt \fBgetch\fP; (b) signal receipt -interrupts \fBgetch\fP and causes it to return \fBERR\fP with \fBerrno\fP set to -\fBEINTR\fP. -.PP -The \fBhas_key\fP function is unique to \fI\%ncurses\fP. -We recommend that -any code using it be conditionalized on the \fBNCURSES_VERSION\fP feature macro. +.\" https://web.archive.org/web/20200923185647/https://man.netbsd.org/curses_input.3 +had added them along with +.BR \%KEY_MOUSE . .SH SEE ALSO \fB\%curses\fP(3X), +\fB\%curs_addch\fP(3X), \fB\%curs_inopts\fP(3X), \fB\%curs_mouse\fP(3X), \fB\%curs_move\fP(3X), \fB\%curs_outopts\fP(3X), \fB\%curs_refresh\fP(3X), \fB\%curs_variables\fP(3X), -\fB\%resizeterm\fP(3X) +\fB\%resizeterm\fP(3X), +\fB\%ascii\fP(7) +.PP +\fB\%curs_get_wch\fP(3X) describes comparable functions of the +.I \%ncurses +library in its wide-character configuration +.RI ( \%ncursesw ). +.PP +ECMA-6 \*(``7-bit coded Character Set\*('' +\%<https://\*:ecma\-international\*:.org/\ +\*:publications\-and\-standards/\*:standards/\*:ecma\-6/> .PP -Comparable functions in the wide-character (ncursesw) library are -described in -\fB\%curs_get_wch\fP(3X). +ECMA-48 \*(``Control Functions for Coded Character Sets\*('' +\%<https://\*:ecma\-international\*:.org/\ +\*:publications\-and\-standards/\*:standards/\*:ecma\-48/> diff --git a/upstream/mageia-cauldron/man3/curs_getstr.3x b/upstream/mageia-cauldron/man3/curs_getstr.3x index 08b39ab4..1e86525d 100644 --- a/upstream/mageia-cauldron/man3/curs_getstr.3x +++ b/upstream/mageia-cauldron/man3/curs_getstr.3x @@ -1,5 +1,5 @@ .\"*************************************************************************** -.\" Copyright 2018-2022,2023 Thomas E. Dickey * +.\" Copyright 2018-2023,2024 Thomas E. Dickey * .\" Copyright 1998-2010,2017 Free Software Foundation, Inc. * .\" * .\" Permission is hereby granted, free of charge, to any person obtaining a * @@ -27,8 +27,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: curs_getstr.3x,v 1.52 2023/12/16 20:32:22 tom Exp $ -.TH curs_getstr 3X 2023-12-16 "ncurses 6.4" "Library calls" +.\" $Id: curs_getstr.3x,v 1.54 2024/03/16 15:35:01 tom Exp $ +.TH curs_getstr 3X 2024-03-16 "ncurses 6.4" "Library calls" .ie \n(.g \{\ .ds `` \(lq .ds '' \(rq diff --git a/upstream/mageia-cauldron/man3/curs_getyx.3x b/upstream/mageia-cauldron/man3/curs_getyx.3x index a358e750..7f6ea66f 100644 --- a/upstream/mageia-cauldron/man3/curs_getyx.3x +++ b/upstream/mageia-cauldron/man3/curs_getyx.3x @@ -1,5 +1,5 @@ .\"*************************************************************************** -.\" Copyright 2020-2022,2023 Thomas E. Dickey * +.\" Copyright 2020-2023,2024 Thomas E. Dickey * .\" Copyright 1998-2007,2010 Free Software Foundation, Inc. * .\" * .\" Permission is hereby granted, free of charge, to any person obtaining a * @@ -27,8 +27,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: curs_getyx.3x,v 1.40 2023/12/16 21:33:21 tom Exp $ -.TH curs_getyx 3X 2023-12-16 "ncurses 6.4" "Library calls" +.\" $Id: curs_getyx.3x,v 1.42 2024/03/16 15:35:01 tom Exp $ +.TH curs_getyx 3X 2024-03-16 "ncurses 6.4" "Library calls" .ie \n(.g \{\ .ds `` \(lq .ds '' \(rq diff --git a/upstream/mageia-cauldron/man3/curs_in_wch.3x b/upstream/mageia-cauldron/man3/curs_in_wch.3x index d7af7b58..b63868ea 100644 --- a/upstream/mageia-cauldron/man3/curs_in_wch.3x +++ b/upstream/mageia-cauldron/man3/curs_in_wch.3x @@ -1,5 +1,5 @@ .\"*************************************************************************** -.\" Copyright 2018-2022,2023 Thomas E. Dickey * +.\" Copyright 2018-2023,2024 Thomas E. Dickey * .\" Copyright 2002-2010,2017 Free Software Foundation, Inc. * .\" * .\" Permission is hereby granted, free of charge, to any person obtaining a * @@ -27,8 +27,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: curs_in_wch.3x,v 1.24 2023/11/18 18:00:11 tom Exp $ -.TH curs_in_wch 3X 2023-11-18 "ncurses 6.4" "Library calls" +.\" $Id: curs_in_wch.3x,v 1.26 2024/03/16 15:35:01 tom Exp $ +.TH curs_in_wch 3X 2024-03-16 "ncurses 6.4" "Library calls" .ie \n(.g \{\ .ds `` \(lq .ds '' \(rq diff --git a/upstream/mageia-cauldron/man3/curs_in_wchstr.3x b/upstream/mageia-cauldron/man3/curs_in_wchstr.3x index 995f4f86..49092bf2 100644 --- a/upstream/mageia-cauldron/man3/curs_in_wchstr.3x +++ b/upstream/mageia-cauldron/man3/curs_in_wchstr.3x @@ -1,5 +1,5 @@ .\"*************************************************************************** -.\" Copyright 2018-2022,2023 Thomas E. Dickey * +.\" Copyright 2018-2023,2024 Thomas E. Dickey * .\" Copyright 2002-2012,2017 Free Software Foundation, Inc. * .\" * .\" Permission is hereby granted, free of charge, to any person obtaining a * @@ -27,8 +27,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: curs_in_wchstr.3x,v 1.32 2023/11/18 20:55:18 tom Exp $ -.TH curs_in_wchstr 3X 2023-11-18 "ncurses 6.4" "Library calls" +.\" $Id: curs_in_wchstr.3x,v 1.34 2024/03/16 15:35:01 tom Exp $ +.TH curs_in_wchstr 3X 2024-03-16 "ncurses 6.4" "Library calls" .ie \n(.g \{\ .ds `` \(lq .ds '' \(rq diff --git a/upstream/mageia-cauldron/man3/curs_inch.3x b/upstream/mageia-cauldron/man3/curs_inch.3x index 54a57228..8173df12 100644 --- a/upstream/mageia-cauldron/man3/curs_inch.3x +++ b/upstream/mageia-cauldron/man3/curs_inch.3x @@ -28,8 +28,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: curs_inch.3x,v 1.44 2024/01/13 22:05:39 tom Exp $ -.TH curs_inch 3X 2024-01-13 "ncurses 6.4" "Library calls" +.\" $Id: curs_inch.3x,v 1.46 2024/03/16 15:35:01 tom Exp $ +.TH curs_inch 3X 2024-03-16 "ncurses 6.4" "Library calls" .ie \n(.g \{\ .ds `` \(lq .ds '' \(rq diff --git a/upstream/mageia-cauldron/man3/curs_inchstr.3x b/upstream/mageia-cauldron/man3/curs_inchstr.3x index 89d4bd1e..11d50226 100644 --- a/upstream/mageia-cauldron/man3/curs_inchstr.3x +++ b/upstream/mageia-cauldron/man3/curs_inchstr.3x @@ -1,5 +1,5 @@ .\"*************************************************************************** -.\" Copyright 2018-2022,2023 Thomas E. Dickey * +.\" Copyright 2018-2023,2024 Thomas E. Dickey * .\" Copyright 1998-2010,2017 Free Software Foundation, Inc. * .\" * .\" Permission is hereby granted, free of charge, to any person obtaining a * @@ -27,8 +27,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: curs_inchstr.3x,v 1.40 2023/11/19 00:08:58 tom Exp $ -.TH curs_inchstr 3X 2023-11-18 "ncurses 6.4" "Library calls" +.\" $Id: curs_inchstr.3x,v 1.42 2024/03/16 15:35:01 tom Exp $ +.TH curs_inchstr 3X 2024-03-16 "ncurses 6.4" "Library calls" .ie \n(.g \{\ .ds `` \(lq .ds '' \(rq diff --git a/upstream/mageia-cauldron/man3/curs_initscr.3x b/upstream/mageia-cauldron/man3/curs_initscr.3x index 3f7c37d6..bcede30d 100644 --- a/upstream/mageia-cauldron/man3/curs_initscr.3x +++ b/upstream/mageia-cauldron/man3/curs_initscr.3x @@ -1,5 +1,5 @@ .\"*************************************************************************** -.\" Copyright 2018-2022,2023 Thomas E. Dickey * +.\" Copyright 2018-2023,2024 Thomas E. Dickey * .\" Copyright 1998-2016,2017 Free Software Foundation, Inc. * .\" * .\" Permission is hereby granted, free of charge, to any person obtaining a * @@ -27,8 +27,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: curs_initscr.3x,v 1.60 2023/12/23 16:27:25 tom Exp $ -.TH curs_initscr 3X 2023-12-23 "ncurses 6.4" "Library calls" +.\" $Id: curs_initscr.3x,v 1.64 2024/03/16 15:35:01 tom Exp $ +.TH curs_initscr 3X 2024-03-16 "ncurses 6.4" "Library calls" .ie \n(.g \{\ .ds `` \(lq .ds '' \(rq @@ -244,7 +244,8 @@ which normally corresponds to a terminal entry with the \fIgeneric\fP (\fIgn\fP) capability. Generic entries are detected by \fBsetupterm\fP(3X) and cannot be used for full-screen operation. -Other implementations may handle a missing/empty \fITERM\fP variable differently. +Other implementations may handle +a missing/empty \fITERM\fP variable differently. .SS "Signal Handlers" Quoting from X/Open Curses Issue 7, section 3.1.1: .RS 5 @@ -270,7 +271,7 @@ Applications which must handle these signals should set up the corresponding handlers \fIafter\fP initializing the library: .TP 5 .B SIGINT -The handler \fIattempts\fP to cleanup the screen on exit. +The handler \fIattempts\fP to clean up the screen on exit. Although it \fIusually\fP works as expected, there are limitations: .RS 5 .bP diff --git a/upstream/mageia-cauldron/man3/curs_inopts.3x b/upstream/mageia-cauldron/man3/curs_inopts.3x index 5dfd3880..fd090fc6 100644 --- a/upstream/mageia-cauldron/man3/curs_inopts.3x +++ b/upstream/mageia-cauldron/man3/curs_inopts.3x @@ -1,6 +1,6 @@ '\" t .\"*************************************************************************** -.\" Copyright 2018-2022,2023 Thomas E. Dickey * +.\" Copyright 2018-2023,2024 Thomas E. Dickey * .\" Copyright 1998-2016,2017 Free Software Foundation, Inc. * .\" * .\" Permission is hereby granted, free of charge, to any person obtaining a * @@ -28,8 +28,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: curs_inopts.3x,v 1.60 2023/12/23 16:36:18 tom Exp $ -.TH curs_inopts 3X 2023-12-23 "ncurses 6.4" "Library calls" +.\" $Id: curs_inopts.3x,v 1.64 2024/03/23 20:38:57 tom Exp $ +.TH curs_inopts 3X 2024-03-23 "ncurses 6.4" "Library calls" .ie \n(.g \{\ .ds `` \(lq .ds '' \(rq @@ -228,7 +228,7 @@ this is equivalent, under POSIX, to setting the CS7 flag on the terminal. The window argument, -.I win, +.IR win , is always ignored. If the terminfo capabilities \fBsmm\fP (meta_on) and @@ -278,7 +278,7 @@ passed through uninterpreted, instead of generating a signal. The behavior of the BREAK key depends on other bits in the terminal driver that are not set by -.I curses. +.IR curses . .\" .SS "qiflush, nqiflush" When the \fB\%noqiflush\fP routine is used, @@ -344,7 +344,7 @@ All routines that return an integer return \fBERR\fP upon failure and upon successful completion, unless otherwise noted in the preceding routine descriptions. .PP -X/Open does not define any error conditions. +X/Open Curses does not specify any error conditions. In this implementation, functions with a window parameter will return an error if it is null. Any function will also return an error if the terminal was not @@ -508,7 +508,7 @@ load key definitions in the order defined by the array of string capability names. The last key to be loaded determines the keycode which will be returned. In -.I \%ncurses, +.IR \%ncurses , you may also have extended capabilities interpreted as key definitions. These are loaded after the predefined keys, and if a capability's value is the same as a previously-loaded diff --git a/upstream/mageia-cauldron/man3/curs_ins_wch.3x b/upstream/mageia-cauldron/man3/curs_ins_wch.3x index 1f2307a1..e855800f 100644 --- a/upstream/mageia-cauldron/man3/curs_ins_wch.3x +++ b/upstream/mageia-cauldron/man3/curs_ins_wch.3x @@ -1,5 +1,5 @@ .\"*************************************************************************** -.\" Copyright 2019-2022,2023 Thomas E. Dickey * +.\" Copyright 2019-2023,2024 Thomas E. Dickey * .\" Copyright 2002-2010,2017 Free Software Foundation, Inc. * .\" * .\" Permission is hereby granted, free of charge, to any person obtaining a * @@ -27,8 +27,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: curs_ins_wch.3x,v 1.26 2023/12/23 16:03:24 tom Exp $ -.TH curs_ins_wch 3X 2023-12-23 "ncurses 6.4" "Library calls" +.\" $Id: curs_ins_wch.3x,v 1.28 2024/03/16 15:35:01 tom Exp $ +.TH curs_ins_wch 3X 2024-03-16 "ncurses 6.4" "Library calls" .ie \n(.g \{\ .ds `` \(lq .ds '' \(rq diff --git a/upstream/mageia-cauldron/man3/curs_ins_wstr.3x b/upstream/mageia-cauldron/man3/curs_ins_wstr.3x index 10000832..375b2f5d 100644 --- a/upstream/mageia-cauldron/man3/curs_ins_wstr.3x +++ b/upstream/mageia-cauldron/man3/curs_ins_wstr.3x @@ -1,5 +1,5 @@ .\"*************************************************************************** -.\" Copyright 2019-2022,2023 Thomas E. Dickey * +.\" Copyright 2019-2023,2024 Thomas E. Dickey * .\" Copyright 2002-2012,2017 Free Software Foundation, Inc. * .\" * .\" Permission is hereby granted, free of charge, to any person obtaining a * @@ -27,8 +27,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: curs_ins_wstr.3x,v 1.30 2023/12/16 20:36:15 tom Exp $ -.TH curs_ins_wstr 3X 2023-12-16 "ncurses 6.4" "Library calls" +.\" $Id: curs_ins_wstr.3x,v 1.32 2024/03/16 15:48:54 tom Exp $ +.TH curs_ins_wstr 3X 2024-03-16 "ncurses 6.4" "Library calls" .ie \n(.g \{\ .ds `` \(lq .ds '' \(rq @@ -89,7 +89,7 @@ Special characters are handled as in \fBwadd_wch\fP(3X). .SH RETURN VALUE All functions return the integer \fBERR\fP upon failure and \fBOK\fP on success. .PP -X/Open does not define any error conditions. +X/Open Curses does not specify any error conditions. This implementation returns an error .bP if the \fIwin\fP parameter is null or diff --git a/upstream/mageia-cauldron/man3/curs_insch.3x b/upstream/mageia-cauldron/man3/curs_insch.3x index 4be93c6b..0c2b5ace 100644 --- a/upstream/mageia-cauldron/man3/curs_insch.3x +++ b/upstream/mageia-cauldron/man3/curs_insch.3x @@ -1,5 +1,5 @@ .\"*************************************************************************** -.\" Copyright 2018-2022,2023 Thomas E. Dickey * +.\" Copyright 2018-2023,2024 Thomas E. Dickey * .\" Copyright 1998-2010,2017 Free Software Foundation, Inc. * .\" * .\" Permission is hereby granted, free of charge, to any person obtaining a * @@ -27,8 +27,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: curs_insch.3x,v 1.36 2023/12/23 16:03:24 tom Exp $ -.TH curs_insch 3X 2023-12-23 "ncurses 6.4" "Library calls" +.\" $Id: curs_insch.3x,v 1.38 2024/03/16 15:35:01 tom Exp $ +.TH curs_insch 3X 2024-03-16 "ncurses 6.4" "Library calls" .ie \n(.g \{\ .ds `` \(lq .ds '' \(rq diff --git a/upstream/mageia-cauldron/man3/curs_insstr.3x b/upstream/mageia-cauldron/man3/curs_insstr.3x index ef338ade..7fc11d4b 100644 --- a/upstream/mageia-cauldron/man3/curs_insstr.3x +++ b/upstream/mageia-cauldron/man3/curs_insstr.3x @@ -1,5 +1,5 @@ .\"*************************************************************************** -.\" Copyright 2019-2022,2023 Thomas E. Dickey * +.\" Copyright 2019-2023,2024 Thomas E. Dickey * .\" Copyright 1998-2010,2017 Free Software Foundation, Inc. * .\" * .\" Permission is hereby granted, free of charge, to any person obtaining a * @@ -27,8 +27,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: curs_insstr.3x,v 1.46 2023/11/25 11:29:34 tom Exp $ -.TH curs_insstr 3X 2023-11-25 "ncurses 6.4" "Library calls" +.\" $Id: curs_insstr.3x,v 1.48 2024/03/16 15:49:07 tom Exp $ +.TH curs_insstr 3X 2024-03-16 "ncurses 6.4" "Library calls" .ie \n(.g \{\ .ds `` \(lq .ds '' \(rq @@ -88,7 +88,7 @@ Special characters are handled as in \fBwaddch\fP(3X). .SH RETURN VALUE All functions return the integer \fBERR\fP upon failure and \fBOK\fP on success. .PP -X/Open does not define any error conditions. +X/Open Curses does not specify any error conditions. This implementation returns an error .bP if the \fIwin\fP parameter is null or diff --git a/upstream/mageia-cauldron/man3/curs_instr.3x b/upstream/mageia-cauldron/man3/curs_instr.3x index 20f42f38..e1385b45 100644 --- a/upstream/mageia-cauldron/man3/curs_instr.3x +++ b/upstream/mageia-cauldron/man3/curs_instr.3x @@ -1,5 +1,5 @@ .\"*************************************************************************** -.\" Copyright 2018-2022,2023 Thomas E. Dickey * +.\" Copyright 2018-2023,2024 Thomas E. Dickey * .\" Copyright 1998-2010,2017 Free Software Foundation, Inc. * .\" * .\" Permission is hereby granted, free of charge, to any person obtaining a * @@ -27,8 +27,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: curs_instr.3x,v 1.44 2023/12/16 20:32:22 tom Exp $ -.TH curs_instr 3X 2023-12-16 "ncurses 6.4" "Library calls" +.\" $Id: curs_instr.3x,v 1.46 2024/03/16 15:35:01 tom Exp $ +.TH curs_instr 3X 2024-03-16 "ncurses 6.4" "Library calls" .ie \n(.g \{\ .ds `` \(lq .ds '' \(rq diff --git a/upstream/mageia-cauldron/man3/curs_inwstr.3x b/upstream/mageia-cauldron/man3/curs_inwstr.3x index b11cb21f..d58f5997 100644 --- a/upstream/mageia-cauldron/man3/curs_inwstr.3x +++ b/upstream/mageia-cauldron/man3/curs_inwstr.3x @@ -1,5 +1,5 @@ .\"*************************************************************************** -.\" Copyright 2018-2022,2023 Thomas E. Dickey * +.\" Copyright 2018-2023,2024 Thomas E. Dickey * .\" Copyright 2002-2012,2017 Free Software Foundation, Inc. * .\" * .\" Permission is hereby granted, free of charge, to any person obtaining a * @@ -27,8 +27,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: curs_inwstr.3x,v 1.36 2023/12/30 21:32:48 tom Exp $ -.TH curs_inwstr 3X 2023-12-30 "ncurses 6.4" "Library calls" +.\" $Id: curs_inwstr.3x,v 1.38 2024/03/16 15:35:01 tom Exp $ +.TH curs_inwstr 3X 2024-03-16 "ncurses 6.4" "Library calls" .ie \n(.g \{\ .ds `` \(lq .ds '' \(rq diff --git a/upstream/mageia-cauldron/man3/curs_kernel.3x b/upstream/mageia-cauldron/man3/curs_kernel.3x index 929439c2..62d38b22 100644 --- a/upstream/mageia-cauldron/man3/curs_kernel.3x +++ b/upstream/mageia-cauldron/man3/curs_kernel.3x @@ -27,8 +27,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: curs_kernel.3x,v 1.53 2024/01/05 21:46:58 tom Exp $ -.TH curs_kernel 3X 2024-01-05 "ncurses 6.4" "Library calls" +.\" $Id: curs_kernel.3x,v 1.56 2024/03/16 15:35:01 tom Exp $ +.TH curs_kernel 3X 2024-03-16 "ncurses 6.4" "Library calls" .ie \n(.g \{\ .ds `` \(lq .ds '' \(rq @@ -135,7 +135,7 @@ most use \fBwmove\fP instead. The \fBripoffline\fP routine provides access to the same facility that \fBslk_init\fP [see \fBcurs_slk\fP(3X)] uses to reduce the size of the screen. -\fBripoffline\fP must be called before \fBinitscr\fP or +\fB\%ripoffline\fP must be called before \fBinitscr\fP or \fBnewterm\fP is called, to prepare these initial actions: .bP If \fIline\fP is positive, a line is removed from the top of \fBstdscr\fP. diff --git a/upstream/mageia-cauldron/man3/curs_legacy.3x b/upstream/mageia-cauldron/man3/curs_legacy.3x index b503991e..a556be44 100644 --- a/upstream/mageia-cauldron/man3/curs_legacy.3x +++ b/upstream/mageia-cauldron/man3/curs_legacy.3x @@ -1,5 +1,5 @@ .\"*************************************************************************** -.\" Copyright 2019-2022,2023 Thomas E. Dickey * +.\" Copyright 2019-2023,2024 Thomas E. Dickey * .\" Copyright 2007-2015,2017 Free Software Foundation, Inc. * .\" * .\" Permission is hereby granted, free of charge, to any person obtaining a * @@ -27,8 +27,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: curs_legacy.3x,v 1.30 2023/12/23 16:40:10 tom Exp $ -.TH curs_legacy 3X 2023-12-23 "ncurses 6.4" "Library calls" +.\" $Id: curs_legacy.3x,v 1.32 2024/03/16 15:35:01 tom Exp $ +.TH curs_legacy 3X 2024-03-16 "ncurses 6.4" "Library calls" .ie \n(.g \{\ .ds `` \(lq .ds '' \(rq diff --git a/upstream/mageia-cauldron/man3/curs_memleaks.3x b/upstream/mageia-cauldron/man3/curs_memleaks.3x index 0f989502..1b4fa937 100644 --- a/upstream/mageia-cauldron/man3/curs_memleaks.3x +++ b/upstream/mageia-cauldron/man3/curs_memleaks.3x @@ -1,5 +1,5 @@ .\"*************************************************************************** -.\" Copyright 2019-2022,2023 Thomas E. Dickey * +.\" Copyright 2019-2023,2024 Thomas E. Dickey * .\" Copyright 2008-2010,2017 Free Software Foundation, Inc. * .\" * .\" Permission is hereby granted, free of charge, to any person obtaining a * @@ -27,8 +27,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: curs_memleaks.3x,v 1.33 2023/12/23 16:22:08 tom Exp $ -.TH curs_memleaks 3X 2023-12-23 "ncurses 6.4" "Library calls" +.\" $Id: curs_memleaks.3x,v 1.35 2024/03/16 15:35:01 tom Exp $ +.TH curs_memleaks 3X 2024-03-16 "ncurses 6.4" "Library calls" .ie \n(.g \{\ .ds `` \(lq .ds '' \(rq diff --git a/upstream/mageia-cauldron/man3/curs_mouse.3x b/upstream/mageia-cauldron/man3/curs_mouse.3x index 9c9048f7..70bc5e93 100644 --- a/upstream/mageia-cauldron/man3/curs_mouse.3x +++ b/upstream/mageia-cauldron/man3/curs_mouse.3x @@ -28,8 +28,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: curs_mouse.3x,v 1.89 2024/02/17 21:43:03 tom Exp $ -.TH curs_mouse 3X 2024-02-17 "ncurses 6.4" "Library calls" +.\" $Id: curs_mouse.3x,v 1.96 2024/03/23 20:38:57 tom Exp $ +.TH curs_mouse 3X 2024-03-23 "ncurses 6.4" "Library calls" .ie \n(.g \{\ .ds `` \(lq .ds '' \(rq @@ -103,7 +103,7 @@ If \fIoldmask\fP is non-\fBNULL\fP, this function fills the indicated location with the previous value of the current screen's mouse event mask. .PP -As a side effect, setting a zero mousemask may turn off the mouse pointer; +As a side effect, setting a zero mouse mask may turn off the mouse pointer; setting a nonzero mask may turn it on. Whether this happens is device-dependent. .SS "Mouse Events" @@ -188,8 +188,8 @@ the screen windows enclose the location of a mouse event. If the parameter is a pad, \fB\%wenclose\fP uses the most recent screen coordinates used for this pad in -\fP\%prefresh\fP(3X) or -\fP\%pnoutrefresh\fP(3X). +\fB\%prefresh\fP(3X) or +\fB\%pnoutrefresh\fP(3X). .SS wmouse_trafo The \fB\%wmouse_trafo\fP function transforms a given pair of coordinates from \fB\%stdscr\fP-relative coordinates @@ -197,7 +197,7 @@ to coordinates relative to the given window or vice versa. The resulting \fB\%stdscr\fP-relative coordinates are not always identical to screen coordinates due to the mechanism to reserve lines on top or bottom of the screen for other purposes -(see the \fB\%ripoffline\fP and \fB\%slk_init\fP(3X) calls, for example). +(see the \fB\%ripoffline\fP(3X) and \fB\%slk_init\fP(3X) calls, for example). .bP If the parameter \fIto_screen\fP is \fBTRUE\fP, the pointers \fIpY, pX\fP must reference the coordinates of a location @@ -230,10 +230,18 @@ using \fB\%stdscr\fP for \fIwin\fP. The \fB\%mouseinterval\fP function sets the maximum time (in thousands of a second) that can elapse between press and release events for them to -be resolved as a click. +be resolved as a +.IR click . +An application might interpret button press and release events separated +by more than the mouse interval as a \*(``long press\*('', +or, +with motion, +as a \*(``drag\*(''. .PP Calling \fB\%mouseinterval(0)\fP disables click resolution. -When ncurses detects a mouse event, +When +.I \%ncurses +detects a mouse event, it awaits further input activity up to this interval, and then checks for a subsequent mouse event which can be combined with the first event. @@ -291,7 +299,7 @@ The order of the \fB\%MEVENT\fP structure members is not guaranteed. Additional fields may be added to the structure in the future. .PP Under -.I \%ncurses, +.IR \%ncurses , these calls are implemented using either .IR \%xterm 's built-in mouse-tracking API or @@ -344,7 +352,7 @@ include \fB\%REPORT_MOUSE_POSITION\fP. They are distinct. For example, in -.I \%xterm, +.IR \%xterm , wheel/scrolling mice send position reports as a sequence of presses of buttons 4 or 5 without matching button-releases. .SH EXTENSIONS @@ -448,9 +456,9 @@ where the mouse was using the \fB\%req_mouse_pos\fP capability. .IP Those features required a terminal program that had been modified to work with SVr4 -.I curses. +.IR curses . They were not part of the X Consortium's -.I \%xterm. +.IR \%xterm . .PP When developing the .I \%xterm @@ -462,7 +470,7 @@ lack of documentation. Later, in 1998, Mark Hesseling provided support in .I \%PDCurses 2.3 using the SVr4 interface. -.I \%PDCurses, +.IR \%PDCurses , however, does not use video terminals, making it unnecessary to be concerned about compatibility with the diff --git a/upstream/mageia-cauldron/man3/curs_move.3x b/upstream/mageia-cauldron/man3/curs_move.3x index 41c912ed..dd2093df 100644 --- a/upstream/mageia-cauldron/man3/curs_move.3x +++ b/upstream/mageia-cauldron/man3/curs_move.3x @@ -1,5 +1,5 @@ .\"*************************************************************************** -.\" Copyright 2018-2022,2023 Thomas E. Dickey * +.\" Copyright 2018-2023,2024 Thomas E. Dickey * .\" Copyright 1998-2010,2017 Free Software Foundation, Inc. * .\" * .\" Permission is hereby granted, free of charge, to any person obtaining a * @@ -27,8 +27,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: curs_move.3x,v 1.33 2023/12/16 21:33:08 tom Exp $ -.TH curs_move 3X 2023-12-16 "ncurses 6.4" "Library calls" +.\" $Id: curs_move.3x,v 1.35 2024/03/16 15:35:01 tom Exp $ +.TH curs_move 3X 2024-03-16 "ncurses 6.4" "Library calls" .ie \n(.g \{\ .ds `` \(lq .ds '' \(rq diff --git a/upstream/mageia-cauldron/man3/curs_opaque.3x b/upstream/mageia-cauldron/man3/curs_opaque.3x index 090b490e..6a723d32 100644 --- a/upstream/mageia-cauldron/man3/curs_opaque.3x +++ b/upstream/mageia-cauldron/man3/curs_opaque.3x @@ -1,5 +1,5 @@ .\"*************************************************************************** -.\" Copyright 2020-2022,2023 Thomas E. Dickey * +.\" Copyright 2020-2023,2024 Thomas E. Dickey * .\" Copyright 2007-2014,2015 Free Software Foundation, Inc. * .\" * .\" Permission is hereby granted, free of charge, to any person obtaining a * @@ -27,8 +27,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: curs_opaque.3x,v 1.41 2023/12/16 20:32:22 tom Exp $ -.TH curs_opaque 3X 2023-12-16 "ncurses 6.4" "Library calls" +.\" $Id: curs_opaque.3x,v 1.43 2024/03/16 15:35:01 tom Exp $ +.TH curs_opaque 3X 2024-03-16 "ncurses 6.4" "Library calls" .ie \n(.g \{\ .ds `` \(lq .ds '' \(rq diff --git a/upstream/mageia-cauldron/man3/curs_outopts.3x b/upstream/mageia-cauldron/man3/curs_outopts.3x index 0a2b38fa..e671b323 100644 --- a/upstream/mageia-cauldron/man3/curs_outopts.3x +++ b/upstream/mageia-cauldron/man3/curs_outopts.3x @@ -27,8 +27,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: curs_outopts.3x,v 1.56 2024/01/05 21:46:58 tom Exp $ -.TH curs_outopts 3X 2024-01-05 "ncurses 6.4" "Library calls" +.\" $Id: curs_outopts.3x,v 1.58 2024/03/16 15:49:18 tom Exp $ +.TH curs_outopts 3X 2024-03-16 "ncurses 6.4" "Library calls" .de bP .ie n .IP \(bu 4 .el .IP \(bu 2 @@ -143,7 +143,7 @@ and \fBERR\fP upon failure. All other routines that return an integer always return \fBOK\fP. .PP -X/Open Curses does not define any error conditions. +X/Open Curses does not specify any error conditions. .PP In this implementation, .bP @@ -153,7 +153,7 @@ will return an error if the window pointer is null \fBwsetscrreg\fP returns an error if the scrolling region limits extend outside the window. .PP -X/Open does not define any error conditions. +X/Open Curses does not specify any error conditions. This implementation returns an error if the window pointer is null. .SH NOTES diff --git a/upstream/mageia-cauldron/man3/curs_overlay.3x b/upstream/mageia-cauldron/man3/curs_overlay.3x index 6df8b621..69267251 100644 --- a/upstream/mageia-cauldron/man3/curs_overlay.3x +++ b/upstream/mageia-cauldron/man3/curs_overlay.3x @@ -27,8 +27,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: curs_overlay.3x,v 1.39 2024/01/05 21:46:58 tom Exp $ -.TH curs_overlay 3X 2024-01-05 "ncurses 6.4" "Library calls" +.\" $Id: curs_overlay.3x,v 1.41 2024/03/16 15:35:01 tom Exp $ +.TH curs_overlay 3X 2024-03-16 "ncurses 6.4" "Library calls" .ie \n(.g \{\ .ds `` \(lq .ds '' \(rq diff --git a/upstream/mageia-cauldron/man3/curs_pad.3x b/upstream/mageia-cauldron/man3/curs_pad.3x index 072cbd59..53cb748b 100644 --- a/upstream/mageia-cauldron/man3/curs_pad.3x +++ b/upstream/mageia-cauldron/man3/curs_pad.3x @@ -27,8 +27,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: curs_pad.3x,v 1.53 2024/01/05 21:46:58 tom Exp $ -.TH curs_pad 3X 2024-01-05 "ncurses 6.4" "Library calls" +.\" $Id: curs_pad.3x,v 1.55 2024/03/16 15:49:29 tom Exp $ +.TH curs_pad 3X 2024-03-16 "ncurses 6.4" "Library calls" .ie \n(.g \{\ .ds `` \(lq .ds '' \(rq @@ -149,7 +149,7 @@ upon successful completion. Functions that return pointers return \fBNULL\fP on error, and set \fB\%errno\fP to \fB\%ENOMEM\fP. .PP -X/Open Curses does not define any error conditions. +X/Open Curses does not specify any error conditions. In this implementation .RS 3 .TP 5 diff --git a/upstream/mageia-cauldron/man3/curs_print.3x b/upstream/mageia-cauldron/man3/curs_print.3x index d98104a2..866257fa 100644 --- a/upstream/mageia-cauldron/man3/curs_print.3x +++ b/upstream/mageia-cauldron/man3/curs_print.3x @@ -1,5 +1,5 @@ .\"*************************************************************************** -.\" Copyright 2018-2022,2023 Thomas E. Dickey * +.\" Copyright 2018-2023,2024 Thomas E. Dickey * .\" Copyright 1998-2010,2017 Free Software Foundation, Inc. * .\" * .\" Permission is hereby granted, free of charge, to any person obtaining a * @@ -27,8 +27,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: curs_print.3x,v 1.36 2023/12/23 16:36:18 tom Exp $ -.TH curs_print 3X 2023-12-23 "ncurses 6.4" "Library calls" +.\" $Id: curs_print.3x,v 1.38 2024/03/16 15:35:01 tom Exp $ +.TH curs_print 3X 2024-03-16 "ncurses 6.4" "Library calls" .SH NAME \fB\%mcprint\fP \- write binary data to printer using \fIterminfo\fR capabilities diff --git a/upstream/mageia-cauldron/man3/curs_printw.3x b/upstream/mageia-cauldron/man3/curs_printw.3x index 15dd10b5..e730ed98 100644 --- a/upstream/mageia-cauldron/man3/curs_printw.3x +++ b/upstream/mageia-cauldron/man3/curs_printw.3x @@ -1,5 +1,5 @@ .\"*************************************************************************** -.\" Copyright 2018-2022,2023 Thomas E. Dickey * +.\" Copyright 2018-2023,2024 Thomas E. Dickey * .\" Copyright 1998-2010,2017 Free Software Foundation, Inc. * .\" * .\" Permission is hereby granted, free of charge, to any person obtaining a * @@ -27,8 +27,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: curs_printw.3x,v 1.47 2023/12/23 14:41:07 tom Exp $ -.TH curs_printw 3X 2023-12-23 "ncurses 6.4" "Library calls" +.\" $Id: curs_printw.3x,v 1.51 2024/03/23 20:38:57 tom Exp $ +.TH curs_printw 3X 2024-03-23 "ncurses 6.4" "Library calls" .ie \n(.g \{\ .ds `` \(lq .ds '' \(rq @@ -96,7 +96,7 @@ upon failure and upon success. .PP In -.I \%ncurses, +.IR \%ncurses , failure occurs if the library cannot allocate enough memory for the buffer into which the output is formatted, or if the window pointer @@ -160,7 +160,7 @@ In 1991 and after the C standard was published), other developers updated the library, using \fI\%stdarg.h\fP internally in 4.4BSD -.I curses. +.IR curses . Even with this improvement, BSD .I curses diff --git a/upstream/mageia-cauldron/man3/curs_refresh.3x b/upstream/mageia-cauldron/man3/curs_refresh.3x index 60528257..f3208bd6 100644 --- a/upstream/mageia-cauldron/man3/curs_refresh.3x +++ b/upstream/mageia-cauldron/man3/curs_refresh.3x @@ -27,8 +27,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: curs_refresh.3x,v 1.42 2024/01/05 21:46:58 tom Exp $ -.TH curs_refresh 3X 2024-01-05 "ncurses 6.4" "Library calls" +.\" $Id: curs_refresh.3x,v 1.44 2024/03/16 15:49:39 tom Exp $ +.TH curs_refresh 3X 2024-03-16 "ncurses 6.4" "Library calls" .ie \n(.g \{\ .ds `` \(lq .ds '' \(rq @@ -133,7 +133,7 @@ These routines return the integer \fBERR\fP upon failure and \fBOK\fP \*(``an integer value other than \fBERR\fP\*('') upon successful completion. .PP -X/Open does not define any error conditions. +X/Open Curses does not specify any error conditions. In this implementation .RS 3 .TP 5 diff --git a/upstream/mageia-cauldron/man3/curs_scanw.3x b/upstream/mageia-cauldron/man3/curs_scanw.3x index cf1977ac..b0d0b108 100644 --- a/upstream/mageia-cauldron/man3/curs_scanw.3x +++ b/upstream/mageia-cauldron/man3/curs_scanw.3x @@ -1,5 +1,5 @@ .\"*************************************************************************** -.\" Copyright 2018-2022,2023 Thomas E. Dickey * +.\" Copyright 2018-2023,2024 Thomas E. Dickey * .\" Copyright 1998-2010,2017 Free Software Foundation, Inc. * .\" * .\" Permission is hereby granted, free of charge, to any person obtaining a * @@ -27,8 +27,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: curs_scanw.3x,v 1.47 2023/12/23 14:41:50 tom Exp $ -.TH curs_scanw 3X 2023-12-23 "ncurses 6.4" "Library calls" +.\" $Id: curs_scanw.3x,v 1.51 2024/03/23 20:41:15 tom Exp $ +.TH curs_scanw 3X 2024-03-23 "ncurses 6.4" "Library calls" .ie \n(.g \{\ .ds `` \(lq .ds '' \(rq @@ -97,7 +97,7 @@ upon failure and otherwise a count of successful conversions; this quantity may be zero. .PP In -.I \%ncurses, +.IR \%ncurses , failure occurs if \fI\%vsscanf\fP(3) returns \fBEOF\fP, or if the window pointer @@ -162,7 +162,7 @@ this may have been an editorial solecism introduced by X/Open, rather than an intentional change. .bP This implementation retains compatibility with SVr4 -.I curses. +.IR curses . As of 2018, NetBSD .I curses @@ -202,7 +202,7 @@ In 1991 and after the C standard was published), other developers updated the library, using \fI\%stdarg.h\fP internally in 4.4BSD -.I curses. +.IR curses . Even with this improvement, BSD .I curses diff --git a/upstream/mageia-cauldron/man3/curs_scr_dump.3x b/upstream/mageia-cauldron/man3/curs_scr_dump.3x index 16c802a1..d6db96f4 100644 --- a/upstream/mageia-cauldron/man3/curs_scr_dump.3x +++ b/upstream/mageia-cauldron/man3/curs_scr_dump.3x @@ -1,5 +1,5 @@ .\"*************************************************************************** -.\" Copyright 2018-2022,2023 Thomas E. Dickey * +.\" Copyright 2018-2023,2024 Thomas E. Dickey * .\" Copyright 1998-2010,2017 Free Software Foundation, Inc. * .\" * .\" Permission is hereby granted, free of charge, to any person obtaining a * @@ -27,8 +27,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: curs_scr_dump.3x,v 1.37 2023/12/30 21:34:11 tom Exp $ -.TH curs_scr_dump 3X 2023-12-30 "ncurses 6.4" "Library calls" +.\" $Id: curs_scr_dump.3x,v 1.41 2024/03/23 20:41:15 tom Exp $ +.TH curs_scr_dump 3X 2024-03-23 "ncurses 6.4" "Library calls" .ie \n(.g \{\ .ds `` \(lq .ds '' \(rq @@ -84,7 +84,7 @@ after performing any further desired updates, call \fB\%doupdate\fP(3X) or similar. .SS scr_init \fB\%scr_init\fP reads -.I filename, +.IR filename , using it to initialize .I curses data structures describing the state of the terminal screen. @@ -125,7 +125,7 @@ These functions return \fBOK\fP on success and \fBERR\fP on failure. X/Open defines no failure conditions. In this implementation, each function fails if it cannot open -.I filename. +.IR filename . .SH NOTES \fB\%scr_init\fP, \fB\%scr_set\fP, diff --git a/upstream/mageia-cauldron/man3/curs_scroll.3x b/upstream/mageia-cauldron/man3/curs_scroll.3x index 59883803..d57ecee0 100644 --- a/upstream/mageia-cauldron/man3/curs_scroll.3x +++ b/upstream/mageia-cauldron/man3/curs_scroll.3x @@ -1,5 +1,5 @@ .\"*************************************************************************** -.\" Copyright 2018-2022,2023 Thomas E. Dickey * +.\" Copyright 2018-2023,2024 Thomas E. Dickey * .\" Copyright 1998-2006,2010 Free Software Foundation, Inc. * .\" * .\" Permission is hereby granted, free of charge, to any person obtaining a * @@ -27,8 +27,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: curs_scroll.3x,v 1.36 2023/12/16 22:52:35 tom Exp $ -.TH curs_scroll 3X 2023-12-16 "ncurses 6.4" "Library calls" +.\" $Id: curs_scroll.3x,v 1.40 2024/03/23 20:41:15 tom Exp $ +.TH curs_scroll 3X 2024-03-23 "ncurses 6.4" "Library calls" .ie \n(.g \{\ .ds `` \(lq .ds '' \(rq @@ -76,14 +76,14 @@ see \fB\%curscr\fP(3X). \fB\%scrl\fP and \fB\%wscrl\fP scroll .B \%stdscr or the specified window up or down depending on the sign of -.I n. +.IR n . .bP For positive -.I n, +.IR n , line \fIi\fP+\fIn\fP becomes \fIi\fP (scrolling up); .bP for negative -.I n, +.IR n , line \fIi\fP-\fIn\fP becomes \fIi\fP (scrolling down). .PP The cursor does not move. diff --git a/upstream/mageia-cauldron/man3/curs_slk.3x b/upstream/mageia-cauldron/man3/curs_slk.3x index e1d39b2d..bfc54a7f 100644 --- a/upstream/mageia-cauldron/man3/curs_slk.3x +++ b/upstream/mageia-cauldron/man3/curs_slk.3x @@ -1,5 +1,5 @@ .\"*************************************************************************** -.\" Copyright 2018-2022,2023 Thomas E. Dickey * +.\" Copyright 2018-2023,2024 Thomas E. Dickey * .\" Copyright 1998-2016,2017 Free Software Foundation, Inc. * .\" * .\" Permission is hereby granted, free of charge, to any person obtaining a * @@ -27,8 +27,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: curs_slk.3x,v 1.67 2023/12/16 21:18:45 tom Exp $ -.TH curs_slk 3X 2023-12-16 "ncurses 6.4" "Library calls" +.\" $Id: curs_slk.3x,v 1.69 2024/03/16 15:35:01 tom Exp $ +.TH curs_slk 3X 2024-03-16 "ncurses 6.4" "Library calls" .ie \n(.g \{\ .ds `` \(lq .ds '' \(rq diff --git a/upstream/mageia-cauldron/man3/curs_sp_funcs.3x b/upstream/mageia-cauldron/man3/curs_sp_funcs.3x index 7f4be401..e6e11a79 100644 --- a/upstream/mageia-cauldron/man3/curs_sp_funcs.3x +++ b/upstream/mageia-cauldron/man3/curs_sp_funcs.3x @@ -1,5 +1,5 @@ .\"*************************************************************************** -.\" Copyright 2018-2022,2023 Thomas E. Dickey * +.\" Copyright 2018-2023,2024 Thomas E. Dickey * .\" Copyright 2010-2015,2017 Free Software Foundation, Inc. * .\" * .\" Permission is hereby granted, free of charge, to any person obtaining a * @@ -27,8 +27,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: curs_sp_funcs.3x,v 1.46 2023/12/23 16:26:05 tom Exp $ -.TH curs_sp_funcs 3X 2023-12-23 "ncurses 6.4" "Library calls" +.\" $Id: curs_sp_funcs.3x,v 1.48 2024/03/16 15:35:01 tom Exp $ +.TH curs_sp_funcs 3X 2024-03-16 "ncurses 6.4" "Library calls" .ie \n(.g \{\ .ds `` \(lq .ds '' \(rq diff --git a/upstream/mageia-cauldron/man3/curs_termattrs.3x b/upstream/mageia-cauldron/man3/curs_termattrs.3x index c0f9aef0..389366c4 100644 --- a/upstream/mageia-cauldron/man3/curs_termattrs.3x +++ b/upstream/mageia-cauldron/man3/curs_termattrs.3x @@ -27,8 +27,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: curs_termattrs.3x,v 1.34 2024/01/05 21:46:58 tom Exp $ -.TH curs_termattrs 3X 2024-01-05 "ncurses 6.4" "Library calls" +.\" $Id: curs_termattrs.3x,v 1.36 2024/03/16 15:35:01 tom Exp $ +.TH curs_termattrs 3X 2024-03-16 "ncurses 6.4" "Library calls" .SH NAME \fB\%baudrate\fP, \fB\%erasechar\fP, diff --git a/upstream/mageia-cauldron/man3/curs_termcap.3x b/upstream/mageia-cauldron/man3/curs_termcap.3x index 721892d2..6f4eec27 100644 --- a/upstream/mageia-cauldron/man3/curs_termcap.3x +++ b/upstream/mageia-cauldron/man3/curs_termcap.3x @@ -1,5 +1,5 @@ .\"*************************************************************************** -.\" Copyright 2018-2022,2023 Thomas E. Dickey * +.\" Copyright 2018-2023,2024 Thomas E. Dickey * .\" Copyright 1998-2017,2018 Free Software Foundation, Inc. * .\" * .\" Permission is hereby granted, free of charge, to any person obtaining a * @@ -27,8 +27,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: curs_termcap.3x,v 1.81 2023/12/30 21:27:22 tom Exp $ -.TH curs_termcap 3X 2023-12-30 "ncurses 6.4" "Library calls" +.\" $Id: curs_termcap.3x,v 1.83 2024/03/16 15:35:01 tom Exp $ +.TH curs_termcap 3X 2024-03-16 "ncurses 6.4" "Library calls" .ie \n(.g \{\ .ds `` \(lq .ds '' \(rq diff --git a/upstream/mageia-cauldron/man3/curs_terminfo.3x b/upstream/mageia-cauldron/man3/curs_terminfo.3x index 8a457056..eb869518 100644 --- a/upstream/mageia-cauldron/man3/curs_terminfo.3x +++ b/upstream/mageia-cauldron/man3/curs_terminfo.3x @@ -28,8 +28,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: curs_terminfo.3x,v 1.129 2024/01/13 22:15:55 tom Exp $ -.TH curs_terminfo 3X 2024-01-13 "ncurses 6.4" "Library calls" +.\" $Id: curs_terminfo.3x,v 1.134 2024/03/23 20:41:15 tom Exp $ +.TH curs_terminfo 3X 2024-03-23 "ncurses 6.4" "Library calls" .ie \n(.g \{\ .ds `` \(lq .ds '' \(rq @@ -228,7 +228,7 @@ initializing the .I \%term\%info structures, but does not set up the output virtualization structures used by -.I curses. +.IR curses . Its parameters follow. .RS 3 .TP 5 @@ -250,9 +250,9 @@ terminal, passing an output .I stream rather than a -.I descriptor. +.IR descriptor . In -.I curses, +.IR curses , the two are the same because \fB\%newterm\fP calls \fB\%setupterm\fP, passing the file descriptor derived from its output stream parameter. .TP 5 @@ -267,7 +267,7 @@ then \fB\%setupterm\fP returns or .B ERR and stores a status value in the integer pointed to by -.I errret. +.IR errret . A return value of .B OK combined with status of @@ -350,13 +350,13 @@ If it is called for different terminal types, capabilities. .PP \fB\%set_curterm\fP sets \fB\%cur_term\fP to -.I \%nterm, +.IR \%nterm , and makes all of the .I \%term\%info Boolean, numeric, and string variables use the values from -.I \%nterm. +.IR \%nterm . It returns the old value of \fB\%cur_term\fP. .PP \fB\%del_curterm\fP frees the space pointed to by @@ -389,7 +389,7 @@ and then restores the bits. \fB\%tparm\fP instantiates the string .I str with parameters -.I pi. +.IR pi . A pointer is returned to the result of .I str with the parameters applied. @@ -503,12 +503,12 @@ specified in \fB\%setupterm\fP. .PP \fB\%vidputs\fP displays the string on the terminal in the video attribute mode -.I attrs, +.IR attrs , which is any combination of the attributes listed in \fB\%curses\fP(3X). The characters are passed to the .IR \%putchar -like function -.I putc. +.IR putc . .PP \fB\%vidattr\fP is like \fB\%vidputs\fP, except that it outputs through \fI\%putchar\fP(3). @@ -525,14 +525,14 @@ They use multiple parameters to represent the character attributes and color; namely, .bP -.I \%attrs, +.IR \%attrs , of type -.I \%attr_t, +.IR \%attr_t , for the attributes and .bP -.I pair, +.IR pair , of type -.I short, +.IR short , for the color pair number. .PP Use the attribute constants prefixed with @@ -573,7 +573,7 @@ because System\ V did this and \fB\%tigetstr\fP return the value of the capability corresponding to the .I \%term\%info -.I cap-code, +.IR cap-code , such as .BR xenl , passed to them. @@ -686,7 +686,7 @@ but it is possible to do that using the \fB\%delscreen\fP(3X) function. .SH RETURN VALUE X/Open Curses defines no failure conditions. In -.I \%ncurses, +.IR \%ncurses , .TP 5 .B del_curtem fails if its terminal parameter is null. @@ -739,7 +739,7 @@ is also provided in the non-wide-character configuration. .\" ******************************************************************** .SH EXTENSIONS The functions marked as extensions were designed for -.I \%ncurses, +.IR \%ncurses , and are not found in SVr4 .IR curses , 4.4BSD @@ -752,7 +752,7 @@ implementation. allows .I opts to be a pointer to -.I int, +.IR int , which overrides the .I pair .RI ( short ) @@ -804,7 +804,7 @@ but is assumed by some applications. .PP Other implementions may not declare the capability name arrays. Some provide them without declaring them. -X/Open does not specify them. +X/Open Curses does not specify them. .PP Extended terminal capability names, as defined by @@ -821,12 +821,12 @@ block-buffered mode on exit .IR curses ), it was problematic because .I \%ncurses -did not allow a reliable way to cleanup on receiving +did not allow a reliable way to clean up on receiving .BR SIGTSTP . .PP The current version (ncurses6) uses output buffers managed directly by -.I \%ncurses. +.IR \%ncurses . Some of the low-level functions described in this manual page write to the standard output. They are not signal-safe. @@ -846,7 +846,7 @@ X/Open Curses uses less effectively than a later design might, in some cases applying it needlessly to values are already constant, and in most cases overlooking parameters which normally would use -.I \%const. +.IR \%const . Using constant parameters for functions which do not use .I \%const may prevent the program from compiling. @@ -939,7 +939,7 @@ the windows console driver by checking if \fB$TERM\fP is set to .SS "Other Portability Issues" In SVr4, \fB\%set_curterm\fP returns an -.I int, +.IR int , .B OK or .BR ERR . diff --git a/upstream/mageia-cauldron/man3/curs_threads.3x b/upstream/mageia-cauldron/man3/curs_threads.3x index 0d327c29..d01e1f36 100644 --- a/upstream/mageia-cauldron/man3/curs_threads.3x +++ b/upstream/mageia-cauldron/man3/curs_threads.3x @@ -28,8 +28,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: curs_threads.3x,v 1.54 2024/01/13 22:05:39 tom Exp $ -.TH curs_threads 3X 2024-01-13 "ncurses 6.4" "Library calls" +.\" $Id: curs_threads.3x,v 1.56 2024/03/16 15:35:01 tom Exp $ +.TH curs_threads 3X 2024-03-16 "ncurses 6.4" "Library calls" .ie \n(.g \{\ .ds `` \(lq .ds '' \(rq diff --git a/upstream/mageia-cauldron/man3/curs_touch.3x b/upstream/mageia-cauldron/man3/curs_touch.3x index 61adaf0f..26e7bb07 100644 --- a/upstream/mageia-cauldron/man3/curs_touch.3x +++ b/upstream/mageia-cauldron/man3/curs_touch.3x @@ -1,5 +1,5 @@ .\"*************************************************************************** -.\" Copyright 2018-2022,2023 Thomas E. Dickey * +.\" Copyright 2018-2023,2024 Thomas E. Dickey * .\" Copyright 1998-2015,2017 Free Software Foundation, Inc. * .\" * .\" Permission is hereby granted, free of charge, to any person obtaining a * @@ -27,8 +27,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: curs_touch.3x,v 1.42 2023/11/25 14:08:05 tom Exp $ -.TH curs_touch 3X 2023-11-25 "ncurses 6.4" "Library calls" +.\" $Id: curs_touch.3x,v 1.44 2024/03/16 15:49:58 tom Exp $ +.TH curs_touch 3X 2024-03-16 "ncurses 6.4" "Library calls" .SH NAME \fB\%touchwin\fP, \fB\%touchline\fP, @@ -81,7 +81,7 @@ All routines return the integer \fBERR\fP upon failure and an integer value other than \fBERR\fP upon successful completion, unless otherwise noted in the preceding routine descriptions. .PP -X/Open does not define any error conditions. +X/Open Curses does not specify any error conditions. In this implementation .RS 3 .TP 5 diff --git a/upstream/mageia-cauldron/man3/curs_trace.3x b/upstream/mageia-cauldron/man3/curs_trace.3x index 2a55275c..98755c3a 100644 --- a/upstream/mageia-cauldron/man3/curs_trace.3x +++ b/upstream/mageia-cauldron/man3/curs_trace.3x @@ -1,5 +1,5 @@ .\"*************************************************************************** -.\" Copyright 2019-2022,2023 Thomas E. Dickey * +.\" Copyright 2019-2023,2024 Thomas E. Dickey * .\" Copyright 2000-2016,2017 Free Software Foundation, Inc. * .\" * .\" Permission is hereby granted, free of charge, to any person obtaining a * @@ -27,8 +27,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: curs_trace.3x,v 1.42 2023/12/23 16:08:25 tom Exp $ -.TH curs_trace 3X 2023-12-23 "ncurses 6.4" "Library calls" +.\" $Id: curs_trace.3x,v 1.47 2024/03/16 15:35:01 tom Exp $ +.TH curs_trace 3X 2024-03-16 "ncurses 6.4" "Library calls" .ie \n(.g \{\ .ds `` \(lq .ds '' \(rq @@ -44,6 +44,17 @@ .ie n .IP \(bu 4 .el .IP \(bu 2 .. +. +.de dS \" Start unfilled display. +.nr aD \n(.j +.na +.. +. +.de dE \" End unfilled display. +.ad \n(.j +.rr aD +.. +. .SH NAME \fB\%curses_trace\fP, \fB\%trace\fP, @@ -192,25 +203,6 @@ Some tracing features are enabled whenever the \fBcurses_trace\fP parameter is nonzero. Some features overlap. The specific names are used as a guideline. -.SS Initialization -These functions check the \fI\%NCURSES_TRACE\fP environment variable, -to set the tracing feature as if \fBcurses_trace\fP was called: -.RS 4 -.PP -filter, -initscr, -new_prescr, -newterm, -nofilter, -restartterm, -ripoffline, -setupterm, -slk_init, -tgetent, -use_env, -use_extended_names, -use_tioctl -.RE .SS "Command-line Utilities" The command-line utilities such as \fBtic\fP(1) provide a verbose option which extends the set of messages written using the \fBcurses_trace\fP function. @@ -233,6 +225,30 @@ and fewer diagnostics are provided by the command-line utilities. .SH RETURN VALUE Routines which return a value are designed to be used as parameters to the \fB_tracef\fP routine. +.SH ENVIRONMENT +.SS NCURSES_TRACE +A positive integral value stored in this variable causes the following +functions to enable the tracing feature as if +.B \%curses_trace +were called. +.PP +.dS +.RS 4 +\fB\%filter\fP, +\fB\%initscr\fP, +\fB\%new_prescr\fP, +\fB\%newterm\fP, +\fB\%nofilter\fP, +\fB\%restartterm\fP, +\fB\%ripoffline\fP, +\fB\%setupterm\fP, +\fB\%slk_init\fP, +\fB\%tgetent\fP, +\fB\%use_env\fP, +\fB\%use_extended_names\fP, +\fB\%use_tioctl\fP +.RE +.dE .SH PORTABILITY These functions are not part of the XSI interface. Some other curses implementations are known to diff --git a/upstream/mageia-cauldron/man3/curs_util.3x b/upstream/mageia-cauldron/man3/curs_util.3x index 527010ce..d6649520 100644 --- a/upstream/mageia-cauldron/man3/curs_util.3x +++ b/upstream/mageia-cauldron/man3/curs_util.3x @@ -28,8 +28,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: curs_util.3x,v 1.95 2024/01/05 21:46:58 tom Exp $ -.TH curs_util 3X 2024-01-05 "ncurses 6.4" "Library calls" +.\" $Id: curs_util.3x,v 1.98 2024/03/16 15:50:09 tom Exp $ +.TH curs_util 3X 2024-03-16 "ncurses 6.4" "Library calls" .ie \n(.g \{\ .ds `` \(lq .ds '' \(rq @@ -288,7 +288,7 @@ upon failure and \fBOK\fP (SVr4 specifies only "an integer value other than .PP Routines that return pointers return \fBNULL\fP on error. .PP -X/Open does not define any error conditions. +X/Open Curses does not specify any error conditions. In this implementation .RS 3 .TP 5 @@ -347,7 +347,8 @@ the University of California, Berkeley (in 1982) and were later (in 1988) incorporated into SVr4. Oddly, there are no such functions in the 4.3BSD curses sources. .bP -Most implementations simply dump the binary \fI\%WINDOW\fP structure to the file. +Most implementations simply dump the binary \fI\%WINDOW\fP structure +to the file. These include SVr4 curses, NetBSD and PDCurses, as well as older \fI\%ncurses\fP versions. This implementation diff --git a/upstream/mageia-cauldron/man3/curs_variables.3x b/upstream/mageia-cauldron/man3/curs_variables.3x index 3a09c40a..9d28735d 100644 --- a/upstream/mageia-cauldron/man3/curs_variables.3x +++ b/upstream/mageia-cauldron/man3/curs_variables.3x @@ -27,8 +27,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: curs_variables.3x,v 1.43 2024/01/05 21:46:58 tom Exp $ -.TH curs_variables 3X 2024-01-05 "ncurses 6.4" "Library calls" +.\" $Id: curs_variables.3x,v 1.45 2024/03/16 15:35:01 tom Exp $ +.TH curs_variables 3X 2024-03-16 "ncurses 6.4" "Library calls" .ie \n(.g \{\ .ds `` \(lq .ds '' \(rq diff --git a/upstream/mageia-cauldron/man3/curs_window.3x b/upstream/mageia-cauldron/man3/curs_window.3x index e1f84207..a0a3238e 100644 --- a/upstream/mageia-cauldron/man3/curs_window.3x +++ b/upstream/mageia-cauldron/man3/curs_window.3x @@ -1,5 +1,5 @@ .\"*************************************************************************** -.\" Copyright 2020-2022,2023 Thomas E. Dickey * +.\" Copyright 2020-2023,2024 Thomas E. Dickey * .\" Copyright 1998-2015,2016 Free Software Foundation, Inc. * .\" * .\" Permission is hereby granted, free of charge, to any person obtaining a * @@ -27,8 +27,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: curs_window.3x,v 1.44 2023/12/16 20:32:22 tom Exp $ -.TH curs_window 3X 2023-12-16 "ncurses 6.4" "Library calls" +.\" $Id: curs_window.3x,v 1.46 2024/03/16 15:35:01 tom Exp $ +.TH curs_window 3X 2024-03-16 "ncurses 6.4" "Library calls" .de bP .ie n .IP \(bu 4 .el .IP \(bu 2 diff --git a/upstream/mageia-cauldron/man3/default_colors.3x b/upstream/mageia-cauldron/man3/default_colors.3x index 8e35221f..a92bf3f6 100644 --- a/upstream/mageia-cauldron/man3/default_colors.3x +++ b/upstream/mageia-cauldron/man3/default_colors.3x @@ -1,5 +1,5 @@ .\"*************************************************************************** -.\" Copyright 2018-2022,2023 Thomas E. Dickey * +.\" Copyright 2018-2023,2024 Thomas E. Dickey * .\" Copyright 2000-2011,2016 Free Software Foundation, Inc. * .\" * .\" Permission is hereby granted, free of charge, to any person obtaining a * @@ -29,8 +29,8 @@ .\" .\" Author: Thomas E. Dickey 1997,1999,2000,2005 .\" -.\" $Id: default_colors.3x,v 1.48 2023/12/16 20:32:22 tom Exp $ -.TH default_colors 3X 2023-12-16 "ncurses 6.4" "Library calls" +.\" $Id: default_colors.3x,v 1.50 2024/03/16 15:35:01 tom Exp $ +.TH default_colors 3X 2024-03-16 "ncurses 6.4" "Library calls" .ie \n(.g \{\ .ds `` \(lq .ds '' \(rq diff --git a/upstream/mageia-cauldron/man3/define_key.3x b/upstream/mageia-cauldron/man3/define_key.3x index 2bbecbdc..43794b81 100644 --- a/upstream/mageia-cauldron/man3/define_key.3x +++ b/upstream/mageia-cauldron/man3/define_key.3x @@ -1,5 +1,5 @@ .\"*************************************************************************** -.\" Copyright 2018-2022,2023 Thomas E. Dickey * +.\" Copyright 2018-2023,2024 Thomas E. Dickey * .\" Copyright 1998-2010,2017 Free Software Foundation, Inc. * .\" * .\" Permission is hereby granted, free of charge, to any person obtaining a * @@ -29,8 +29,8 @@ .\" .\" Author: Thomas E. Dickey 1997 .\" -.\" $Id: define_key.3x,v 1.40 2023/12/16 20:32:22 tom Exp $ -.TH define_key 3X 2023-12-16 "ncurses 6.4" "Library calls" +.\" $Id: define_key.3x,v 1.42 2024/03/16 15:35:01 tom Exp $ +.TH define_key 3X 2024-03-16 "ncurses 6.4" "Library calls" .SH NAME \fB\%define_key\fP \- define a \fIcurses\fR keycode diff --git a/upstream/mageia-cauldron/man3/form.3x b/upstream/mageia-cauldron/man3/form.3x index f00dfbc9..f412bbcb 100644 --- a/upstream/mageia-cauldron/man3/form.3x +++ b/upstream/mageia-cauldron/man3/form.3x @@ -1,6 +1,6 @@ '\" t .\"*************************************************************************** -.\" Copyright 2018-2021,2023 Thomas E. Dickey * +.\" Copyright 2018-2023,2024 Thomas E. Dickey * .\" Copyright 1998-2016,2017 Free Software Foundation, Inc. * .\" * .\" Permission is hereby granted, free of charge, to any person obtaining a * @@ -28,8 +28,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: form.3x,v 1.52 2023/12/23 16:08:25 tom Exp $ -.TH form 3X 2023-12-23 "ncurses 6.4" "Library calls" +.\" $Id: form.3x,v 1.54 2024/03/16 15:35:01 tom Exp $ +.TH form 3X 2024-03-16 "ncurses 6.4" "Library calls" .ie \n(.g \{\ .ds `` \(lq .ds '' \(rq diff --git a/upstream/mageia-cauldron/man3/form_cursor.3x b/upstream/mageia-cauldron/man3/form_cursor.3x index 04afa9a1..e52dc64f 100644 --- a/upstream/mageia-cauldron/man3/form_cursor.3x +++ b/upstream/mageia-cauldron/man3/form_cursor.3x @@ -1,6 +1,6 @@ '\" t .\"*************************************************************************** -.\" Copyright 2018-2022,2023 Thomas E. Dickey * +.\" Copyright 2018-2023,2024 Thomas E. Dickey * .\" Copyright 1998-2010,2015 Free Software Foundation, Inc. * .\" * .\" Permission is hereby granted, free of charge, to any person obtaining a * @@ -28,8 +28,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: form_cursor.3x,v 1.29 2023/11/25 13:58:47 tom Exp $ -.TH form_cursor 3X 2023-11-25 "ncurses 6.4" "Library calls" +.\" $Id: form_cursor.3x,v 1.31 2024/03/16 15:35:01 tom Exp $ +.TH form_cursor 3X 2024-03-16 "ncurses 6.4" "Library calls" .SH NAME \fBpos_form_cursor\fP \- position a form window cursor diff --git a/upstream/mageia-cauldron/man3/form_data.3x b/upstream/mageia-cauldron/man3/form_data.3x index c062ecf1..d63f2f50 100644 --- a/upstream/mageia-cauldron/man3/form_data.3x +++ b/upstream/mageia-cauldron/man3/form_data.3x @@ -1,6 +1,6 @@ '\" t .\"*************************************************************************** -.\" Copyright 2018-2022,2023 Thomas E. Dickey * +.\" Copyright 2018-2023,2024 Thomas E. Dickey * .\" Copyright 1998-2010,2015 Free Software Foundation, Inc. * .\" * .\" Permission is hereby granted, free of charge, to any person obtaining a * @@ -28,8 +28,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: form_data.3x,v 1.30 2023/11/25 13:58:47 tom Exp $ -.TH form_data 3X 2023-11-25 "ncurses 6.4" "Library calls" +.\" $Id: form_data.3x,v 1.32 2024/03/16 15:35:01 tom Exp $ +.TH form_data 3X 2024-03-16 "ncurses 6.4" "Library calls" .SH NAME \fBdata_ahead\fP, \fBdata_behind\fP \- diff --git a/upstream/mageia-cauldron/man3/form_driver.3x b/upstream/mageia-cauldron/man3/form_driver.3x index 1b8abcc6..64c403fa 100644 --- a/upstream/mageia-cauldron/man3/form_driver.3x +++ b/upstream/mageia-cauldron/man3/form_driver.3x @@ -28,8 +28,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: form_driver.3x,v 1.57 2024/01/13 22:05:39 tom Exp $ -.TH form_driver 3X 2024-01-13 "ncurses 6.4" "Library calls" +.\" $Id: form_driver.3x,v 1.59 2024/03/16 15:35:01 tom Exp $ +.TH form_driver 3X 2024-03-16 "ncurses 6.4" "Library calls" .de bP .ie n .IP \(bu 4 .el .IP \(bu 2 diff --git a/upstream/mageia-cauldron/man3/form_field.3x b/upstream/mageia-cauldron/man3/form_field.3x index a4362539..8baf77b9 100644 --- a/upstream/mageia-cauldron/man3/form_field.3x +++ b/upstream/mageia-cauldron/man3/form_field.3x @@ -1,6 +1,6 @@ '\" t .\"*************************************************************************** -.\" Copyright 2018-2022,2023 Thomas E. Dickey * +.\" Copyright 2018-2023,2024 Thomas E. Dickey * .\" Copyright 1998-2010,2012 Free Software Foundation, Inc. * .\" * .\" Permission is hereby granted, free of charge, to any person obtaining a * @@ -28,8 +28,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: form_field.3x,v 1.32 2023/11/25 13:58:47 tom Exp $ -.TH form_field 3X 2023-11-25 "ncurses 6.4" "Library calls" +.\" $Id: form_field.3x,v 1.34 2024/03/16 15:35:01 tom Exp $ +.TH form_field 3X 2024-03-16 "ncurses 6.4" "Library calls" .SH NAME \fBform_field\fP \- make and break connections between fields and forms diff --git a/upstream/mageia-cauldron/man3/form_field_attributes.3x b/upstream/mageia-cauldron/man3/form_field_attributes.3x index ecd4c31b..87c52662 100644 --- a/upstream/mageia-cauldron/man3/form_field_attributes.3x +++ b/upstream/mageia-cauldron/man3/form_field_attributes.3x @@ -1,6 +1,6 @@ '\" t .\"*************************************************************************** -.\" Copyright 2018-2022,2023 Thomas E. Dickey * +.\" Copyright 2018-2023,2024 Thomas E. Dickey * .\" Copyright 1998-2006,2010 Free Software Foundation, Inc. * .\" * .\" Permission is hereby granted, free of charge, to any person obtaining a * @@ -28,8 +28,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: form_field_attributes.3x,v 1.33 2023/11/25 13:58:47 tom Exp $ -.TH form_field_attributes 3X 2023-11-25 "ncurses 6.4" "Library calls" +.\" $Id: form_field_attributes.3x,v 1.35 2024/03/16 15:35:01 tom Exp $ +.TH form_field_attributes 3X 2024-03-16 "ncurses 6.4" "Library calls" .ie \n(.g \{\ .ds `` \(lq .ds '' \(rq diff --git a/upstream/mageia-cauldron/man3/form_field_buffer.3x b/upstream/mageia-cauldron/man3/form_field_buffer.3x index ec883b6d..a36df808 100644 --- a/upstream/mageia-cauldron/man3/form_field_buffer.3x +++ b/upstream/mageia-cauldron/man3/form_field_buffer.3x @@ -1,5 +1,5 @@ .\"*************************************************************************** -.\" Copyright 2018-2022,2023 Thomas E. Dickey * +.\" Copyright 2018-2023,2024 Thomas E. Dickey * .\" Copyright 1998-2010,2017 Free Software Foundation, Inc. * .\" * .\" Permission is hereby granted, free of charge, to any person obtaining a * @@ -27,8 +27,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: form_field_buffer.3x,v 1.43 2023/12/16 20:32:22 tom Exp $ -.TH form_field_buffer 3X 2023-12-16 "ncurses 6.4" "Library calls" +.\" $Id: form_field_buffer.3x,v 1.45 2024/03/16 15:35:01 tom Exp $ +.TH form_field_buffer 3X 2024-03-16 "ncurses 6.4" "Library calls" .ie \n(.g \{\ .ds `` \(lq .ds '' \(rq diff --git a/upstream/mageia-cauldron/man3/form_field_info.3x b/upstream/mageia-cauldron/man3/form_field_info.3x index a40b605f..93659922 100644 --- a/upstream/mageia-cauldron/man3/form_field_info.3x +++ b/upstream/mageia-cauldron/man3/form_field_info.3x @@ -1,5 +1,5 @@ .\"*************************************************************************** -.\" Copyright 2018-2022,2023 Thomas E. Dickey * +.\" Copyright 2018-2023,2024 Thomas E. Dickey * .\" Copyright 1998-2010,2015 Free Software Foundation, Inc. * .\" * .\" Permission is hereby granted, free of charge, to any person obtaining a * @@ -27,8 +27,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: form_field_info.3x,v 1.30 2023/11/25 13:58:47 tom Exp $ -.TH form_field_info 3X 2023-11-25 "ncurses 6.4" "Library calls" +.\" $Id: form_field_info.3x,v 1.32 2024/03/16 15:35:01 tom Exp $ +.TH form_field_info 3X 2024-03-16 "ncurses 6.4" "Library calls" .ie \n(.g \{\ .ds `` \(lq .ds '' \(rq diff --git a/upstream/mageia-cauldron/man3/form_field_just.3x b/upstream/mageia-cauldron/man3/form_field_just.3x index 7294a179..cd99e056 100644 --- a/upstream/mageia-cauldron/man3/form_field_just.3x +++ b/upstream/mageia-cauldron/man3/form_field_just.3x @@ -1,5 +1,5 @@ .\"*************************************************************************** -.\" Copyright 2018-2022,2023 Thomas E. Dickey * +.\" Copyright 2018-2023,2024 Thomas E. Dickey * .\" Copyright 1998-2010,2015 Free Software Foundation, Inc. * .\" * .\" Permission is hereby granted, free of charge, to any person obtaining a * @@ -27,8 +27,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: form_field_just.3x,v 1.33 2023/11/25 13:58:47 tom Exp $ -.TH form_field_just 3X 2023-11-25 "ncurses 6.4" "Library calls" +.\" $Id: form_field_just.3x,v 1.35 2024/03/16 15:35:01 tom Exp $ +.TH form_field_just 3X 2024-03-16 "ncurses 6.4" "Library calls" .ie \n(.g \{\ .ds `` \(lq .ds '' \(rq diff --git a/upstream/mageia-cauldron/man3/form_field_new.3x b/upstream/mageia-cauldron/man3/form_field_new.3x index 78f77ac5..ee089cf8 100644 --- a/upstream/mageia-cauldron/man3/form_field_new.3x +++ b/upstream/mageia-cauldron/man3/form_field_new.3x @@ -1,5 +1,5 @@ .\"*************************************************************************** -.\" Copyright 2018-2022,2023 Thomas E. Dickey * +.\" Copyright 2018-2023,2024 Thomas E. Dickey * .\" Copyright 1998-2010,2015 Free Software Foundation, Inc. * .\" * .\" Permission is hereby granted, free of charge, to any person obtaining a * @@ -27,8 +27,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: form_field_new.3x,v 1.39 2023/11/25 13:58:47 tom Exp $ -.TH form_field_new 3X 2023-11-25 "ncurses 6.4" "Library calls" +.\" $Id: form_field_new.3x,v 1.41 2024/03/16 15:35:01 tom Exp $ +.TH form_field_new 3X 2024-03-16 "ncurses 6.4" "Library calls" .SH NAME \fBnew_field\fP, \fBdup_field\fP, diff --git a/upstream/mageia-cauldron/man3/form_field_opts.3x b/upstream/mageia-cauldron/man3/form_field_opts.3x index 79671029..b9ea0acd 100644 --- a/upstream/mageia-cauldron/man3/form_field_opts.3x +++ b/upstream/mageia-cauldron/man3/form_field_opts.3x @@ -1,5 +1,5 @@ .\"*************************************************************************** -.\" Copyright 2018-2022,2023 Thomas E. Dickey * +.\" Copyright 2018-2023,2024 Thomas E. Dickey * .\" Copyright 1998-2014,2015 Free Software Foundation, Inc. * .\" * .\" Permission is hereby granted, free of charge, to any person obtaining a * @@ -27,8 +27,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: form_field_opts.3x,v 1.42 2023/11/25 13:58:47 tom Exp $ -.TH form_field_opts 3X 2023-11-25 "ncurses 6.4" "Library calls" +.\" $Id: form_field_opts.3x,v 1.44 2024/03/16 15:35:01 tom Exp $ +.TH form_field_opts 3X 2024-03-16 "ncurses 6.4" "Library calls" .SH NAME \fBset_field_opts\fP, \fBfield_opts_on\fP, diff --git a/upstream/mageia-cauldron/man3/form_field_userptr.3x b/upstream/mageia-cauldron/man3/form_field_userptr.3x index d667ca12..eafa010f 100644 --- a/upstream/mageia-cauldron/man3/form_field_userptr.3x +++ b/upstream/mageia-cauldron/man3/form_field_userptr.3x @@ -1,5 +1,5 @@ .\"*************************************************************************** -.\" Copyright 2018-2022,2023 Thomas E. Dickey * +.\" Copyright 2018-2023,2024 Thomas E. Dickey * .\" Copyright 1998-2010,2015 Free Software Foundation, Inc. * .\" * .\" Permission is hereby granted, free of charge, to any person obtaining a * @@ -27,8 +27,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: form_field_userptr.3x,v 1.28 2023/11/25 13:58:47 tom Exp $ -.TH form_field_userptr 3X 2023-11-25 "ncurses 6.4" "Library calls" +.\" $Id: form_field_userptr.3x,v 1.30 2024/03/16 15:35:01 tom Exp $ +.TH form_field_userptr 3X 2024-03-16 "ncurses 6.4" "Library calls" .SH NAME \fBset_field_userptr\fP, \fBfield_userptr\fP \- diff --git a/upstream/mageia-cauldron/man3/form_field_validation.3x b/upstream/mageia-cauldron/man3/form_field_validation.3x index 0a4f2e99..13efe4d2 100644 --- a/upstream/mageia-cauldron/man3/form_field_validation.3x +++ b/upstream/mageia-cauldron/man3/form_field_validation.3x @@ -1,5 +1,5 @@ .\"*************************************************************************** -.\" Copyright 2018-2022,2023 Thomas E. Dickey * +.\" Copyright 2018-2023,2024 Thomas E. Dickey * .\" Copyright 1998-2010,2017 Free Software Foundation, Inc. * .\" * .\" Permission is hereby granted, free of charge, to any person obtaining a * @@ -27,8 +27,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: form_field_validation.3x,v 1.51 2023/12/16 20:32:22 tom Exp $ -.TH form_field_validation 3X 2023-12-16 "ncurses 6.4" "Library calls" +.\" $Id: form_field_validation.3x,v 1.53 2024/03/16 15:35:01 tom Exp $ +.TH form_field_validation 3X 2024-03-16 "ncurses 6.4" "Library calls" .ie \n(.g \{\ .ds `` \(lq .ds '' \(rq diff --git a/upstream/mageia-cauldron/man3/form_fieldtype.3x b/upstream/mageia-cauldron/man3/form_fieldtype.3x index b94ff965..eefaa516 100644 --- a/upstream/mageia-cauldron/man3/form_fieldtype.3x +++ b/upstream/mageia-cauldron/man3/form_fieldtype.3x @@ -1,5 +1,5 @@ .\"*************************************************************************** -.\" Copyright 2018-2022,2023 Thomas E. Dickey * +.\" Copyright 2018-2023,2024 Thomas E. Dickey * .\" Copyright 1998-2006,2010 Free Software Foundation, Inc. * .\" * .\" Permission is hereby granted, free of charge, to any person obtaining a * @@ -27,8 +27,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: form_fieldtype.3x,v 1.44 2023/11/25 13:58:47 tom Exp $ -.TH form_fieldtype 3X 2023-11-25 "ncurses 6.4" "Library calls" +.\" $Id: form_fieldtype.3x,v 1.46 2024/03/16 15:35:01 tom Exp $ +.TH form_fieldtype 3X 2024-03-16 "ncurses 6.4" "Library calls" .de bP .ie n .IP \(bu 4 .el .IP \(bu 2 diff --git a/upstream/mageia-cauldron/man3/form_hook.3x b/upstream/mageia-cauldron/man3/form_hook.3x index d1ae78a6..297b647e 100644 --- a/upstream/mageia-cauldron/man3/form_hook.3x +++ b/upstream/mageia-cauldron/man3/form_hook.3x @@ -27,8 +27,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: form_hook.3x,v 1.35 2024/01/20 18:12:04 tom Exp $ -.TH form_hook 3X 2024-01-20 "ncurses 6.4" "Library calls" +.\" $Id: form_hook.3x,v 1.37 2024/03/16 15:35:01 tom Exp $ +.TH form_hook 3X 2024-03-16 "ncurses 6.4" "Library calls" .SH NAME \fBform_hook\fP \- set hooks for automatic invocation by applications diff --git a/upstream/mageia-cauldron/man3/form_new.3x b/upstream/mageia-cauldron/man3/form_new.3x index edc3ac03..328e8a33 100644 --- a/upstream/mageia-cauldron/man3/form_new.3x +++ b/upstream/mageia-cauldron/man3/form_new.3x @@ -1,5 +1,5 @@ .\"*************************************************************************** -.\" Copyright 2018-2022,2023 Thomas E. Dickey * +.\" Copyright 2018-2023,2024 Thomas E. Dickey * .\" Copyright 1998-2010,2015 Free Software Foundation, Inc. * .\" * .\" Permission is hereby granted, free of charge, to any person obtaining a * @@ -27,8 +27,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: form_new.3x,v 1.30 2023/11/25 13:58:47 tom Exp $ -.TH form_new 3X 2023-11-25 "ncurses 6.4" "Library calls" +.\" $Id: form_new.3x,v 1.32 2024/03/16 15:35:01 tom Exp $ +.TH form_new 3X 2024-03-16 "ncurses 6.4" "Library calls" .SH NAME \fBnew_form\fP, \fBfree_form\fP \- diff --git a/upstream/mageia-cauldron/man3/form_new_page.3x b/upstream/mageia-cauldron/man3/form_new_page.3x index 234a4ed6..e5ecba8d 100644 --- a/upstream/mageia-cauldron/man3/form_new_page.3x +++ b/upstream/mageia-cauldron/man3/form_new_page.3x @@ -1,5 +1,5 @@ .\"*************************************************************************** -.\" Copyright 2018-2022,2023 Thomas E. Dickey * +.\" Copyright 2018-2023,2024 Thomas E. Dickey * .\" Copyright 1998-2010,2015 Free Software Foundation, Inc. * .\" * .\" Permission is hereby granted, free of charge, to any person obtaining a * @@ -27,8 +27,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: form_new_page.3x,v 1.32 2023/11/25 13:58:47 tom Exp $ -.TH form_new_page 3X 2023-11-25 "ncurses 6.4" "Library calls" +.\" $Id: form_new_page.3x,v 1.34 2024/03/16 15:35:01 tom Exp $ +.TH form_new_page 3X 2024-03-16 "ncurses 6.4" "Library calls" .ie \n(.g \{\ .ds `` \(lq .ds '' \(rq diff --git a/upstream/mageia-cauldron/man3/form_opts.3x b/upstream/mageia-cauldron/man3/form_opts.3x index 1b60d9ba..aacd32f2 100644 --- a/upstream/mageia-cauldron/man3/form_opts.3x +++ b/upstream/mageia-cauldron/man3/form_opts.3x @@ -1,5 +1,5 @@ .\"*************************************************************************** -.\" Copyright 2018-2022,2023 Thomas E. Dickey * +.\" Copyright 2018-2023,2024 Thomas E. Dickey * .\" Copyright 1998-2010,2015 Free Software Foundation, Inc. * .\" * .\" Permission is hereby granted, free of charge, to any person obtaining a * @@ -27,8 +27,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: form_opts.3x,v 1.32 2023/11/25 13:58:47 tom Exp $ -.TH form_opts 3X 2023-11-25 "ncurses 6.4" "Library calls" +.\" $Id: form_opts.3x,v 1.34 2024/03/16 15:35:01 tom Exp $ +.TH form_opts 3X 2024-03-16 "ncurses 6.4" "Library calls" .SH NAME \fBset_form_opts\fP, \fBform_opts_on\fP, diff --git a/upstream/mageia-cauldron/man3/form_page.3x b/upstream/mageia-cauldron/man3/form_page.3x index 9d1f2d86..c147d628 100644 --- a/upstream/mageia-cauldron/man3/form_page.3x +++ b/upstream/mageia-cauldron/man3/form_page.3x @@ -1,5 +1,5 @@ .\"*************************************************************************** -.\" Copyright 2018-2022,2023 Thomas E. Dickey * +.\" Copyright 2018-2023,2024 Thomas E. Dickey * .\" Copyright 1998-2010,2016 Free Software Foundation, Inc. * .\" * .\" Permission is hereby granted, free of charge, to any person obtaining a * @@ -27,8 +27,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: form_page.3x,v 1.35 2023/12/16 20:32:22 tom Exp $ -.TH form_page 3X 2023-12-16 "ncurses 6.4" "Library calls" +.\" $Id: form_page.3x,v 1.37 2024/03/16 15:35:01 tom Exp $ +.TH form_page 3X 2024-03-16 "ncurses 6.4" "Library calls" .SH NAME \fBform_page\fP \- set and get form page number diff --git a/upstream/mageia-cauldron/man3/form_post.3x b/upstream/mageia-cauldron/man3/form_post.3x index ec5272a0..9661ae36 100644 --- a/upstream/mageia-cauldron/man3/form_post.3x +++ b/upstream/mageia-cauldron/man3/form_post.3x @@ -1,5 +1,5 @@ .\"*************************************************************************** -.\" Copyright 2018-2022,2023 Thomas E. Dickey * +.\" Copyright 2018-2023,2024 Thomas E. Dickey * .\" Copyright 1998-2015,2017 Free Software Foundation, Inc. * .\" * .\" Permission is hereby granted, free of charge, to any person obtaining a * @@ -27,8 +27,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: form_post.3x,v 1.31 2023/11/25 13:58:47 tom Exp $ -.TH form_post 3X 2023-11-25 "ncurses 6.4" "Library calls" +.\" $Id: form_post.3x,v 1.33 2024/03/16 15:35:01 tom Exp $ +.TH form_post 3X 2024-03-16 "ncurses 6.4" "Library calls" .SH NAME \fBpost_form\fP, \fBunpost_form\fP \- diff --git a/upstream/mageia-cauldron/man3/form_requestname.3x b/upstream/mageia-cauldron/man3/form_requestname.3x index e1d6e480..e7b3acc8 100644 --- a/upstream/mageia-cauldron/man3/form_requestname.3x +++ b/upstream/mageia-cauldron/man3/form_requestname.3x @@ -1,5 +1,5 @@ .\"*************************************************************************** -.\" Copyright 2018-2022,2023 Thomas E. Dickey * +.\" Copyright 2018-2023,2024 Thomas E. Dickey * .\" Copyright 1998-2010,2015 Free Software Foundation, Inc. * .\" * .\" Permission is hereby granted, free of charge, to any person obtaining a * @@ -27,8 +27,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: form_requestname.3x,v 1.33 2023/12/16 20:32:22 tom Exp $ -.TH form_requestname 3X 2023-12-16 "ncurses 6.4" "Library calls" +.\" $Id: form_requestname.3x,v 1.35 2024/03/16 15:35:01 tom Exp $ +.TH form_requestname 3X 2024-03-16 "ncurses 6.4" "Library calls" .SH NAME \fBform_request_by_name\fP, \fBform_request_name\fP \- diff --git a/upstream/mageia-cauldron/man3/form_userptr.3x b/upstream/mageia-cauldron/man3/form_userptr.3x index ada88629..5b5e551d 100644 --- a/upstream/mageia-cauldron/man3/form_userptr.3x +++ b/upstream/mageia-cauldron/man3/form_userptr.3x @@ -1,5 +1,5 @@ .\"*************************************************************************** -.\" Copyright 2018-2022,2023 Thomas E. Dickey * +.\" Copyright 2018-2023,2024 Thomas E. Dickey * .\" Copyright 1998-2010,2015 Free Software Foundation, Inc. * .\" * .\" Permission is hereby granted, free of charge, to any person obtaining a * @@ -27,8 +27,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: form_userptr.3x,v 1.34 2023/11/25 13:58:47 tom Exp $ -.TH form_userptr 3X 2023-11-25 "ncurses 6.4" "Library calls" +.\" $Id: form_userptr.3x,v 1.36 2024/03/16 15:35:01 tom Exp $ +.TH form_userptr 3X 2024-03-16 "ncurses 6.4" "Library calls" .SH NAME \fBset_form_userptr\fP, \fBform_userptr\fP \- diff --git a/upstream/mageia-cauldron/man3/form_variables.3x b/upstream/mageia-cauldron/man3/form_variables.3x index ad4d609f..7705f162 100644 --- a/upstream/mageia-cauldron/man3/form_variables.3x +++ b/upstream/mageia-cauldron/man3/form_variables.3x @@ -1,5 +1,5 @@ .\"*************************************************************************** -.\" Copyright 2020-2021,2023 Thomas E. Dickey * +.\" Copyright 2020-2023,2024 Thomas E. Dickey * .\" Copyright 2010-2013,2017 Free Software Foundation, Inc. * .\" * .\" Permission is hereby granted, free of charge, to any person obtaining a * @@ -27,8 +27,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: form_variables.3x,v 1.16 2023/10/07 21:19:07 tom Exp $ -.TH form_variables 3X 2023-10-07 "ncurses 6.4" "Library calls" +.\" $Id: form_variables.3x,v 1.18 2024/03/16 15:35:01 tom Exp $ +.TH form_variables 3X 2024-03-16 "ncurses 6.4" "Library calls" .SH NAME \fB\%TYPE_ALNUM\fP, \fB\%TYPE_ALPHA\fP, diff --git a/upstream/mageia-cauldron/man3/form_win.3x b/upstream/mageia-cauldron/man3/form_win.3x index 600185a4..c114d7c2 100644 --- a/upstream/mageia-cauldron/man3/form_win.3x +++ b/upstream/mageia-cauldron/man3/form_win.3x @@ -1,5 +1,5 @@ .\"*************************************************************************** -.\" Copyright 2018-2022,2023 Thomas E. Dickey * +.\" Copyright 2018-2023,2024 Thomas E. Dickey * .\" Copyright 1998-2006,2010 Free Software Foundation, Inc. * .\" * .\" Permission is hereby granted, free of charge, to any person obtaining a * @@ -27,8 +27,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: form_win.3x,v 1.33 2023/11/25 13:58:47 tom Exp $ -.TH form_win 3X 2023-11-25 "ncurses 6.4" "Library calls" +.\" $Id: form_win.3x,v 1.35 2024/03/16 15:35:01 tom Exp $ +.TH form_win 3X 2024-03-16 "ncurses 6.4" "Library calls" .SH NAME \fBform_win\fP \- make and break form window and subwindow associations diff --git a/upstream/mageia-cauldron/man3/grub2-get-kernel-settings.3 b/upstream/mageia-cauldron/man3/grub2-get-kernel-settings.3 index f1062006..60be8236 100644 --- a/upstream/mageia-cauldron/man3/grub2-get-kernel-settings.3 +++ b/upstream/mageia-cauldron/man3/grub2-get-kernel-settings.3 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.49.3. -.TH GRUB-GET-KERNEL-SETTINGS "3" "September 2023" "GRUB 2.06" "User Commands" +.TH GRUB-GET-KERNEL-SETTINGS "3" "March 2024" "GRUB 2.06" "User Commands" .SH NAME grub-get-kernel-settings \- Evaluate the system's kernel installation settings for use while making a grub configuration file .SH SYNOPSIS diff --git a/upstream/mageia-cauldron/man3/key_defined.3x b/upstream/mageia-cauldron/man3/key_defined.3x index 26bf5375..1e913722 100644 --- a/upstream/mageia-cauldron/man3/key_defined.3x +++ b/upstream/mageia-cauldron/man3/key_defined.3x @@ -1,5 +1,5 @@ .\"*************************************************************************** -.\" Copyright 2018-2022,2023 Thomas E. Dickey * +.\" Copyright 2018-2023,2024 Thomas E. Dickey * .\" Copyright 2003-2006,2010 Free Software Foundation, Inc. * .\" * .\" Permission is hereby granted, free of charge, to any person obtaining a * @@ -29,8 +29,8 @@ .\" .\" Author: Thomas E. Dickey 2003 .\" -.\" $Id: key_defined.3x,v 1.32 2023/12/16 20:32:22 tom Exp $ -.TH key_defined 3X 2023-12-16 "ncurses 6.4" "Library calls" +.\" $Id: key_defined.3x,v 1.34 2024/03/16 15:35:01 tom Exp $ +.TH key_defined 3X 2024-03-16 "ncurses 6.4" "Library calls" .SH NAME \fB\%key_defined\fP \- test whether a \fIcurses\fR keycode is defined diff --git a/upstream/mageia-cauldron/man3/keybound.3x b/upstream/mageia-cauldron/man3/keybound.3x index ca646d1a..ac593f72 100644 --- a/upstream/mageia-cauldron/man3/keybound.3x +++ b/upstream/mageia-cauldron/man3/keybound.3x @@ -1,5 +1,5 @@ .\"*************************************************************************** -.\" Copyright 2018-2022,2023 Thomas E. Dickey * +.\" Copyright 2018-2023,2024 Thomas E. Dickey * .\" Copyright 1999-2008,2010 Free Software Foundation, Inc. * .\" * .\" Permission is hereby granted, free of charge, to any person obtaining a * @@ -29,8 +29,8 @@ .\" .\" Author: Thomas E. Dickey 1999 .\" -.\" $Id: keybound.3x,v 1.34 2023/12/16 20:32:22 tom Exp $ -.TH keybound 3X 2023-12-16 "ncurses 6.4" "Library calls" +.\" $Id: keybound.3x,v 1.36 2024/03/16 15:35:01 tom Exp $ +.TH keybound 3X 2024-03-16 "ncurses 6.4" "Library calls" .SH NAME \fB\%keybound\fP \- get definition of \fIcurses\fR keycode diff --git a/upstream/mageia-cauldron/man3/keyok.3x b/upstream/mageia-cauldron/man3/keyok.3x index 0fe90747..529ca45a 100644 --- a/upstream/mageia-cauldron/man3/keyok.3x +++ b/upstream/mageia-cauldron/man3/keyok.3x @@ -1,5 +1,5 @@ .\"*************************************************************************** -.\" Copyright 2018-2022,2023 Thomas E. Dickey * +.\" Copyright 2018-2023,2024 Thomas E. Dickey * .\" Copyright 1998-2010,2017 Free Software Foundation, Inc. * .\" * .\" Permission is hereby granted, free of charge, to any person obtaining a * @@ -29,8 +29,8 @@ .\" .\" Author: Thomas E. Dickey 1997 .\" -.\" $Id: keyok.3x,v 1.38 2023/12/16 20:32:22 tom Exp $ -.TH keyok 3X 2023-12-16 "ncurses 6.4" "Library calls" +.\" $Id: keyok.3x,v 1.40 2024/03/16 15:35:01 tom Exp $ +.TH keyok 3X 2024-03-16 "ncurses 6.4" "Library calls" .SH NAME \fB\%keyok\fP \- enable or disable a \fIcurses\fR keycode diff --git a/upstream/mageia-cauldron/man3/legacy_coding.3x b/upstream/mageia-cauldron/man3/legacy_coding.3x index e057fa5f..2297ca99 100644 --- a/upstream/mageia-cauldron/man3/legacy_coding.3x +++ b/upstream/mageia-cauldron/man3/legacy_coding.3x @@ -1,5 +1,5 @@ .\"*************************************************************************** -.\" Copyright 2020-2022,2023 Thomas E. Dickey * +.\" Copyright 2020-2023,2024 Thomas E. Dickey * .\" Copyright 2005-2016,2017 Free Software Foundation, Inc. * .\" * .\" Permission is hereby granted, free of charge, to any person obtaining a * @@ -29,8 +29,8 @@ .\" .\" Author: Thomas E. Dickey .\" -.\" $Id: legacy_coding.3x,v 1.24 2023/12/16 20:32:22 tom Exp $ -.TH legacy_coding 3X 2023-12-16 "ncurses 6.4" "Library calls" +.\" $Id: legacy_coding.3x,v 1.26 2024/03/16 15:35:01 tom Exp $ +.TH legacy_coding 3X 2024-03-16 "ncurses 6.4" "Library calls" .SH NAME \fB\%use_legacy_coding\fP \- override \fIcurses\fR locale encoding checks diff --git a/upstream/mageia-cauldron/man3/menu.3x b/upstream/mageia-cauldron/man3/menu.3x index 57dae665..a8e00ec8 100644 --- a/upstream/mageia-cauldron/man3/menu.3x +++ b/upstream/mageia-cauldron/man3/menu.3x @@ -1,6 +1,6 @@ '\" t .\"*************************************************************************** -.\" Copyright 2018-2021,2023 Thomas E. Dickey * +.\" Copyright 2018-2023,2024 Thomas E. Dickey * .\" Copyright 1998-2014,2017 Free Software Foundation, Inc. * .\" * .\" Permission is hereby granted, free of charge, to any person obtaining a * @@ -28,8 +28,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: menu.3x,v 1.43 2023/12/23 16:08:25 tom Exp $ -.TH menu 3X 2023-12-23 "ncurses 6.4" "Library calls" +.\" $Id: menu.3x,v 1.45 2024/03/16 15:35:01 tom Exp $ +.TH menu 3X 2024-03-16 "ncurses 6.4" "Library calls" .ie \n(.g \{\ .ds `` \(lq .ds '' \(rq diff --git a/upstream/mageia-cauldron/man3/menu_attributes.3x b/upstream/mageia-cauldron/man3/menu_attributes.3x index 397a72bf..b4f64d00 100644 --- a/upstream/mageia-cauldron/man3/menu_attributes.3x +++ b/upstream/mageia-cauldron/man3/menu_attributes.3x @@ -1,5 +1,5 @@ .\"*************************************************************************** -.\" Copyright 2018-2022,2023 Thomas E. Dickey * +.\" Copyright 2018-2023,2024 Thomas E. Dickey * .\" Copyright 1998-2010,2015 Free Software Foundation, Inc. * .\" * .\" Permission is hereby granted, free of charge, to any person obtaining a * @@ -27,8 +27,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: menu_attributes.3x,v 1.34 2023/11/25 13:58:47 tom Exp $ -.TH menu_attributes 3X 2023-11-25 "ncurses 6.4" "Library calls" +.\" $Id: menu_attributes.3x,v 1.36 2024/03/16 15:35:01 tom Exp $ +.TH menu_attributes 3X 2024-03-16 "ncurses 6.4" "Library calls" .ie \n(.g \{\ .ds `` \(lq .ds '' \(rq diff --git a/upstream/mageia-cauldron/man3/menu_cursor.3x b/upstream/mageia-cauldron/man3/menu_cursor.3x index 5319e08c..aa8b262d 100644 --- a/upstream/mageia-cauldron/man3/menu_cursor.3x +++ b/upstream/mageia-cauldron/man3/menu_cursor.3x @@ -1,5 +1,5 @@ .\"*************************************************************************** -.\" Copyright 2018-2022,2023 Thomas E. Dickey * +.\" Copyright 2018-2023,2024 Thomas E. Dickey * .\" Copyright 1998-2010,2015 Free Software Foundation, Inc. * .\" * .\" Permission is hereby granted, free of charge, to any person obtaining a * @@ -27,8 +27,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: menu_cursor.3x,v 1.28 2023/11/25 13:58:47 tom Exp $ -.TH menu_cursor 3X 2023-11-25 "ncurses 6.4" "Library calls" +.\" $Id: menu_cursor.3x,v 1.30 2024/03/16 15:35:01 tom Exp $ +.TH menu_cursor 3X 2024-03-16 "ncurses 6.4" "Library calls" .SH NAME \fBpos_menu_cursor\fP \- position a menu's cursor diff --git a/upstream/mageia-cauldron/man3/menu_driver.3x b/upstream/mageia-cauldron/man3/menu_driver.3x index 3204d1f5..9c68e0fd 100644 --- a/upstream/mageia-cauldron/man3/menu_driver.3x +++ b/upstream/mageia-cauldron/man3/menu_driver.3x @@ -1,5 +1,5 @@ .\"*************************************************************************** -.\" Copyright 2018-2022,2023 Thomas E. Dickey * +.\" Copyright 2018-2023,2024 Thomas E. Dickey * .\" Copyright 1998-2010,2017 Free Software Foundation, Inc. * .\" * .\" Permission is hereby granted, free of charge, to any person obtaining a * @@ -27,8 +27,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: menu_driver.3x,v 1.45 2023/12/23 16:08:25 tom Exp $ -.TH menu_driver 3X 2023-12-23 "ncurses 6.4" "Library calls" +.\" $Id: menu_driver.3x,v 1.47 2024/03/16 15:35:01 tom Exp $ +.TH menu_driver 3X 2024-03-16 "ncurses 6.4" "Library calls" .de bP .ie n .IP \(bu 4 .el .IP \(bu 2 diff --git a/upstream/mageia-cauldron/man3/menu_format.3x b/upstream/mageia-cauldron/man3/menu_format.3x index 8372b18d..530d7cf6 100644 --- a/upstream/mageia-cauldron/man3/menu_format.3x +++ b/upstream/mageia-cauldron/man3/menu_format.3x @@ -1,5 +1,5 @@ .\"*************************************************************************** -.\" Copyright 2018-2022,2023 Thomas E. Dickey * +.\" Copyright 2018-2023,2024 Thomas E. Dickey * .\" Copyright 1998-2015,2016 Free Software Foundation, Inc. * .\" * .\" Permission is hereby granted, free of charge, to any person obtaining a * @@ -27,8 +27,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: menu_format.3x,v 1.33 2023/11/25 13:58:47 tom Exp $ -.TH menu_format 3X 2023-11-25 "ncurses 6.4" "Library calls" +.\" $Id: menu_format.3x,v 1.35 2024/03/16 15:35:01 tom Exp $ +.TH menu_format 3X 2024-03-16 "ncurses 6.4" "Library calls" .SH NAME \fBset_menu_format\fP, \fBmenu_format\fP \- diff --git a/upstream/mageia-cauldron/man3/menu_hook.3x b/upstream/mageia-cauldron/man3/menu_hook.3x index a2d23526..53b64011 100644 --- a/upstream/mageia-cauldron/man3/menu_hook.3x +++ b/upstream/mageia-cauldron/man3/menu_hook.3x @@ -1,5 +1,5 @@ .\"*************************************************************************** -.\" Copyright 2018-2022,2023 Thomas E. Dickey * +.\" Copyright 2018-2023,2024 Thomas E. Dickey * .\" Copyright 1998-2007,2010 Free Software Foundation, Inc. * .\" * .\" Permission is hereby granted, free of charge, to any person obtaining a * @@ -27,8 +27,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: menu_hook.3x,v 1.30 2023/11/25 13:58:47 tom Exp $ -.TH menu_hook 3X 2023-11-25 "ncurses 6.4" "Library calls" +.\" $Id: menu_hook.3x,v 1.32 2024/03/16 15:35:01 tom Exp $ +.TH menu_hook 3X 2024-03-16 "ncurses 6.4" "Library calls" .SH NAME \fBmenu_hook\fP \- set hooks for automatic invocation by applications diff --git a/upstream/mageia-cauldron/man3/menu_items.3x b/upstream/mageia-cauldron/man3/menu_items.3x index 6c6d1cdf..fb33ae52 100644 --- a/upstream/mageia-cauldron/man3/menu_items.3x +++ b/upstream/mageia-cauldron/man3/menu_items.3x @@ -1,5 +1,5 @@ .\"*************************************************************************** -.\" Copyright 2018-2022,2023 Thomas E. Dickey * +.\" Copyright 2018-2023,2024 Thomas E. Dickey * .\" Copyright 1998-2012,2015 Free Software Foundation, Inc. * .\" * .\" Permission is hereby granted, free of charge, to any person obtaining a * @@ -27,8 +27,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: menu_items.3x,v 1.32 2023/11/25 13:58:47 tom Exp $ -.TH menu_items 3X 2023-11-25 "ncurses 6.4" "Library calls" +.\" $Id: menu_items.3x,v 1.34 2024/03/16 15:35:01 tom Exp $ +.TH menu_items 3X 2024-03-16 "ncurses 6.4" "Library calls" .SH NAME \fBset_menu_items\fP, \fBmenu_items\fP, diff --git a/upstream/mageia-cauldron/man3/menu_mark.3x b/upstream/mageia-cauldron/man3/menu_mark.3x index bcdf3340..092c5d64 100644 --- a/upstream/mageia-cauldron/man3/menu_mark.3x +++ b/upstream/mageia-cauldron/man3/menu_mark.3x @@ -1,5 +1,5 @@ .\"*************************************************************************** -.\" Copyright 2018-2022,2023 Thomas E. Dickey * +.\" Copyright 2018-2023,2024 Thomas E. Dickey * .\" Copyright 1998-2010,2015 Free Software Foundation, Inc. * .\" * .\" Permission is hereby granted, free of charge, to any person obtaining a * @@ -27,8 +27,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: menu_mark.3x,v 1.33 2023/11/25 13:58:47 tom Exp $ -.TH menu_mark 3X 2023-11-25 "ncurses 6.4" "Library calls" +.\" $Id: menu_mark.3x,v 1.35 2024/03/16 15:35:01 tom Exp $ +.TH menu_mark 3X 2024-03-16 "ncurses 6.4" "Library calls" .SH NAME \fBset_menu_mark\fP, \fBmenu_mark\fP \- diff --git a/upstream/mageia-cauldron/man3/menu_new.3x b/upstream/mageia-cauldron/man3/menu_new.3x index 30bd686d..8df26cba 100644 --- a/upstream/mageia-cauldron/man3/menu_new.3x +++ b/upstream/mageia-cauldron/man3/menu_new.3x @@ -1,5 +1,5 @@ .\"*************************************************************************** -.\" Copyright 2018-2022,2023 Thomas E. Dickey * +.\" Copyright 2018-2023,2024 Thomas E. Dickey * .\" Copyright 1998-2010,2015 Free Software Foundation, Inc. * .\" * .\" Permission is hereby granted, free of charge, to any person obtaining a * @@ -27,8 +27,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: menu_new.3x,v 1.33 2023/11/25 13:58:47 tom Exp $ -.TH menu_new 3X 2023-11-25 "ncurses 6.4" "Library calls" +.\" $Id: menu_new.3x,v 1.35 2024/03/16 15:35:01 tom Exp $ +.TH menu_new 3X 2024-03-16 "ncurses 6.4" "Library calls" .SH NAME \fBnew_menu\fP, \fBfree_menu\fP \- diff --git a/upstream/mageia-cauldron/man3/menu_opts.3x b/upstream/mageia-cauldron/man3/menu_opts.3x index ad7a392c..08cf545f 100644 --- a/upstream/mageia-cauldron/man3/menu_opts.3x +++ b/upstream/mageia-cauldron/man3/menu_opts.3x @@ -1,5 +1,5 @@ .\"*************************************************************************** -.\" Copyright 2018-2022,2023 Thomas E. Dickey * +.\" Copyright 2018-2023,2024 Thomas E. Dickey * .\" Copyright 1998-2015,2016 Free Software Foundation, Inc. * .\" * .\" Permission is hereby granted, free of charge, to any person obtaining a * @@ -27,8 +27,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: menu_opts.3x,v 1.33 2023/11/25 13:58:47 tom Exp $ -.TH menu_opts 3X 2023-11-25 "ncurses 6.4" "Library calls" +.\" $Id: menu_opts.3x,v 1.35 2024/03/16 15:35:01 tom Exp $ +.TH menu_opts 3X 2024-03-16 "ncurses 6.4" "Library calls" .SH NAME \fBset_menu_opts\fP, \fBmenu_opts_on\fP, diff --git a/upstream/mageia-cauldron/man3/menu_pattern.3x b/upstream/mageia-cauldron/man3/menu_pattern.3x index 2b00fb77..65400dae 100644 --- a/upstream/mageia-cauldron/man3/menu_pattern.3x +++ b/upstream/mageia-cauldron/man3/menu_pattern.3x @@ -1,5 +1,5 @@ .\"*************************************************************************** -.\" Copyright 2018-2022,2023 Thomas E. Dickey * +.\" Copyright 2018-2023,2024 Thomas E. Dickey * .\" Copyright 1998-2010,2015 Free Software Foundation, Inc. * .\" * .\" Permission is hereby granted, free of charge, to any person obtaining a * @@ -27,8 +27,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: menu_pattern.3x,v 1.36 2023/11/25 13:58:47 tom Exp $ -.TH menu_pattern 3X 2023-11-25 "ncurses 6.4" "Library calls" +.\" $Id: menu_pattern.3x,v 1.38 2024/03/16 15:35:01 tom Exp $ +.TH menu_pattern 3X 2024-03-16 "ncurses 6.4" "Library calls" .SH NAME \fBset_menu_pattern\fP, \fBmenu_pattern\fP \- diff --git a/upstream/mageia-cauldron/man3/menu_post.3x b/upstream/mageia-cauldron/man3/menu_post.3x index d33a98c3..e98ffc81 100644 --- a/upstream/mageia-cauldron/man3/menu_post.3x +++ b/upstream/mageia-cauldron/man3/menu_post.3x @@ -1,5 +1,5 @@ .\"*************************************************************************** -.\" Copyright 2018-2022,2023 Thomas E. Dickey * +.\" Copyright 2018-2023,2024 Thomas E. Dickey * .\" Copyright 1998-2016,2017 Free Software Foundation, Inc. * .\" * .\" Permission is hereby granted, free of charge, to any person obtaining a * @@ -27,8 +27,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: menu_post.3x,v 1.34 2023/11/25 13:58:47 tom Exp $ -.TH menu_post 3X 2023-11-25 "ncurses 6.4" "Library calls" +.\" $Id: menu_post.3x,v 1.36 2024/03/16 15:35:01 tom Exp $ +.TH menu_post 3X 2024-03-16 "ncurses 6.4" "Library calls" .SH NAME \fBpost_menu\fP, \fBunpost_menu\fP \- diff --git a/upstream/mageia-cauldron/man3/menu_requestname.3x b/upstream/mageia-cauldron/man3/menu_requestname.3x index 56105ea1..b7a6c227 100644 --- a/upstream/mageia-cauldron/man3/menu_requestname.3x +++ b/upstream/mageia-cauldron/man3/menu_requestname.3x @@ -1,5 +1,5 @@ .\"*************************************************************************** -.\" Copyright 2018-2022,2023 Thomas E. Dickey * +.\" Copyright 2018-2023,2024 Thomas E. Dickey * .\" Copyright 1998-2010,2015 Free Software Foundation, Inc. * .\" * .\" Permission is hereby granted, free of charge, to any person obtaining a * @@ -27,8 +27,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: menu_requestname.3x,v 1.31 2023/12/16 20:32:22 tom Exp $ -.TH menu_requestname 3X 2023-12-16 "ncurses 6.4" "Library calls" +.\" $Id: menu_requestname.3x,v 1.33 2024/03/16 15:35:01 tom Exp $ +.TH menu_requestname 3X 2024-03-16 "ncurses 6.4" "Library calls" .SH NAME \fBmenu_request_by_name\fP, \fBmenu_request_name\fP \- diff --git a/upstream/mageia-cauldron/man3/menu_spacing.3x b/upstream/mageia-cauldron/man3/menu_spacing.3x index 94eab424..8b75ff4c 100644 --- a/upstream/mageia-cauldron/man3/menu_spacing.3x +++ b/upstream/mageia-cauldron/man3/menu_spacing.3x @@ -1,5 +1,5 @@ .\"*************************************************************************** -.\" Copyright 2018-2022,2023 Thomas E. Dickey * +.\" Copyright 2018-2023,2024 Thomas E. Dickey * .\" Copyright 1998-2010,2015 Free Software Foundation, Inc. * .\" * .\" Permission is hereby granted, free of charge, to any person obtaining a * @@ -27,8 +27,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: menu_spacing.3x,v 1.35 2023/12/16 20:32:22 tom Exp $ -.TH menu_spacing 3X 2023-12-16 "ncurses 6.4" "Library calls" +.\" $Id: menu_spacing.3x,v 1.37 2024/03/16 15:35:01 tom Exp $ +.TH menu_spacing 3X 2024-03-16 "ncurses 6.4" "Library calls" .SH NAME \fBset_menu_spacing\fP, \fBmenu_spacing\fP \- diff --git a/upstream/mageia-cauldron/man3/menu_userptr.3x b/upstream/mageia-cauldron/man3/menu_userptr.3x index 52efb334..5259b72a 100644 --- a/upstream/mageia-cauldron/man3/menu_userptr.3x +++ b/upstream/mageia-cauldron/man3/menu_userptr.3x @@ -1,5 +1,5 @@ .\"*************************************************************************** -.\" Copyright 2018-2022,2023 Thomas E. Dickey * +.\" Copyright 2018-2023,2024 Thomas E. Dickey * .\" Copyright 1998-2010,2015 Free Software Foundation, Inc. * .\" * .\" Permission is hereby granted, free of charge, to any person obtaining a * @@ -27,8 +27,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: menu_userptr.3x,v 1.31 2023/11/25 13:58:47 tom Exp $ -.TH menu_userptr 3X 2023-11-25 "ncurses 6.4" "Library calls" +.\" $Id: menu_userptr.3x,v 1.33 2024/03/16 15:35:01 tom Exp $ +.TH menu_userptr 3X 2024-03-16 "ncurses 6.4" "Library calls" .SH NAME \fBset_menu_userptr\fP, \fBmenu_userptr\fP \- diff --git a/upstream/mageia-cauldron/man3/menu_win.3x b/upstream/mageia-cauldron/man3/menu_win.3x index 71798787..4559a18c 100644 --- a/upstream/mageia-cauldron/man3/menu_win.3x +++ b/upstream/mageia-cauldron/man3/menu_win.3x @@ -1,5 +1,5 @@ .\"*************************************************************************** -.\" Copyright 2018-2022,2023 Thomas E. Dickey * +.\" Copyright 2018-2023,2024 Thomas E. Dickey * .\" Copyright 1998-2006,2010 Free Software Foundation, Inc. * .\" * .\" Permission is hereby granted, free of charge, to any person obtaining a * @@ -27,8 +27,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: menu_win.3x,v 1.30 2023/11/25 13:58:47 tom Exp $ -.TH menu_win 3X 2023-11-25 "ncurses 6.4" "Library calls" +.\" $Id: menu_win.3x,v 1.32 2024/03/16 15:35:01 tom Exp $ +.TH menu_win 3X 2024-03-16 "ncurses 6.4" "Library calls" .SH NAME \fBmenu_win\fP \- make and break menu window and subwindow associations diff --git a/upstream/mageia-cauldron/man3/mitem_current.3x b/upstream/mageia-cauldron/man3/mitem_current.3x index 59f77b1b..d455ca4d 100644 --- a/upstream/mageia-cauldron/man3/mitem_current.3x +++ b/upstream/mageia-cauldron/man3/mitem_current.3x @@ -1,5 +1,5 @@ .\"*************************************************************************** -.\" Copyright 2018-2022,2023 Thomas E. Dickey * +.\" Copyright 2018-2023,2024 Thomas E. Dickey * .\" Copyright 1998-2006,2010 Free Software Foundation, Inc. * .\" * .\" Permission is hereby granted, free of charge, to any person obtaining a * @@ -27,8 +27,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: mitem_current.3x,v 1.35 2023/11/25 13:58:47 tom Exp $ -.TH mitem_current 3X 2023-11-25 "ncurses 6.4" "Library calls" +.\" $Id: mitem_current.3x,v 1.37 2024/03/16 15:35:01 tom Exp $ +.TH mitem_current 3X 2024-03-16 "ncurses 6.4" "Library calls" .SH NAME \fBmitem_current\fP \- set and get current_menu_item diff --git a/upstream/mageia-cauldron/man3/mitem_name.3x b/upstream/mageia-cauldron/man3/mitem_name.3x index fe1b90cf..271db056 100644 --- a/upstream/mageia-cauldron/man3/mitem_name.3x +++ b/upstream/mageia-cauldron/man3/mitem_name.3x @@ -1,5 +1,5 @@ .\"*************************************************************************** -.\" Copyright 2018-2022,2023 Thomas E. Dickey * +.\" Copyright 2018-2023,2024 Thomas E. Dickey * .\" Copyright 1998-2010,2015 Free Software Foundation, Inc. * .\" * .\" Permission is hereby granted, free of charge, to any person obtaining a * @@ -27,8 +27,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: mitem_name.3x,v 1.29 2023/11/25 13:58:47 tom Exp $ -.TH mitem_name 3X 2023-11-25 "ncurses 6.4" "Library calls" +.\" $Id: mitem_name.3x,v 1.31 2024/03/16 15:35:01 tom Exp $ +.TH mitem_name 3X 2024-03-16 "ncurses 6.4" "Library calls" .SH NAME \fBitem_name\fP, \fBitem_description\fP \- diff --git a/upstream/mageia-cauldron/man3/mitem_new.3x b/upstream/mageia-cauldron/man3/mitem_new.3x index f93ef3a1..31d097e7 100644 --- a/upstream/mageia-cauldron/man3/mitem_new.3x +++ b/upstream/mageia-cauldron/man3/mitem_new.3x @@ -1,5 +1,5 @@ .\"*************************************************************************** -.\" Copyright 2018-2022,2023 Thomas E. Dickey * +.\" Copyright 2018-2023,2024 Thomas E. Dickey * .\" Copyright 1998-2010,2015 Free Software Foundation, Inc. * .\" * .\" Permission is hereby granted, free of charge, to any person obtaining a * @@ -27,8 +27,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: mitem_new.3x,v 1.34 2023/11/25 13:58:47 tom Exp $ -.TH mitem_new 3X 2023-11-25 "ncurses 6.4" "Library calls" +.\" $Id: mitem_new.3x,v 1.36 2024/03/16 15:35:01 tom Exp $ +.TH mitem_new 3X 2024-03-16 "ncurses 6.4" "Library calls" .SH NAME \fBnew_item\fP, \fBfree_item\fP \- diff --git a/upstream/mageia-cauldron/man3/mitem_opts.3x b/upstream/mageia-cauldron/man3/mitem_opts.3x index 0c14c252..c83edf92 100644 --- a/upstream/mageia-cauldron/man3/mitem_opts.3x +++ b/upstream/mageia-cauldron/man3/mitem_opts.3x @@ -1,5 +1,5 @@ .\"*************************************************************************** -.\" Copyright 2018-2022,2023 Thomas E. Dickey * +.\" Copyright 2018-2023,2024 Thomas E. Dickey * .\" Copyright 1998-2010,2015 Free Software Foundation, Inc. * .\" * .\" Permission is hereby granted, free of charge, to any person obtaining a * @@ -27,8 +27,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: mitem_opts.3x,v 1.31 2023/11/25 13:58:47 tom Exp $ -.TH mitem_opts 3X 2023-11-25 "ncurses 6.4" "Library calls" +.\" $Id: mitem_opts.3x,v 1.33 2024/03/16 15:35:01 tom Exp $ +.TH mitem_opts 3X 2024-03-16 "ncurses 6.4" "Library calls" .SH NAME \fBset_item_opts\fP, \fBitem_opts_on\fP, diff --git a/upstream/mageia-cauldron/man3/mitem_userptr.3x b/upstream/mageia-cauldron/man3/mitem_userptr.3x index d1a2530d..8e7c8bbb 100644 --- a/upstream/mageia-cauldron/man3/mitem_userptr.3x +++ b/upstream/mageia-cauldron/man3/mitem_userptr.3x @@ -1,5 +1,5 @@ .\"*************************************************************************** -.\" Copyright 2018-2022,2023 Thomas E. Dickey * +.\" Copyright 2018-2023,2024 Thomas E. Dickey * .\" Copyright 1998-2010,2015 Free Software Foundation, Inc. * .\" * .\" Permission is hereby granted, free of charge, to any person obtaining a * @@ -27,8 +27,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: mitem_userptr.3x,v 1.32 2023/11/25 13:58:47 tom Exp $ -.TH mitem_userptr 3X 2023-11-25 "ncurses 6.4" "Library calls" +.\" $Id: mitem_userptr.3x,v 1.34 2024/03/16 15:35:01 tom Exp $ +.TH mitem_userptr 3X 2024-03-16 "ncurses 6.4" "Library calls" .SH NAME \fBset_item_userptr\fP, \fBitem_userptr\fP \- diff --git a/upstream/mageia-cauldron/man3/mitem_value.3x b/upstream/mageia-cauldron/man3/mitem_value.3x index 8bec8644..c3c27637 100644 --- a/upstream/mageia-cauldron/man3/mitem_value.3x +++ b/upstream/mageia-cauldron/man3/mitem_value.3x @@ -1,5 +1,5 @@ .\"*************************************************************************** -.\" Copyright 2018-2022,2023 Thomas E. Dickey * +.\" Copyright 2018-2023,2024 Thomas E. Dickey * .\" Copyright 1998-2010,2015 Free Software Foundation, Inc. * .\" * .\" Permission is hereby granted, free of charge, to any person obtaining a * @@ -27,8 +27,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: mitem_value.3x,v 1.30 2023/11/25 13:58:47 tom Exp $ -.TH mitem_value 3X 2023-11-25 "ncurses 6.4" "Library calls" +.\" $Id: mitem_value.3x,v 1.32 2024/03/16 15:35:01 tom Exp $ +.TH mitem_value 3X 2024-03-16 "ncurses 6.4" "Library calls" .SH NAME \fBset_item_value\fP, \fBitem_value\fP \- diff --git a/upstream/mageia-cauldron/man3/mitem_visible.3x b/upstream/mageia-cauldron/man3/mitem_visible.3x index 98f924af..84761dc6 100644 --- a/upstream/mageia-cauldron/man3/mitem_visible.3x +++ b/upstream/mageia-cauldron/man3/mitem_visible.3x @@ -1,5 +1,5 @@ .\"*************************************************************************** -.\" Copyright 2018-2022,2023 Thomas E. Dickey * +.\" Copyright 2018-2023,2024 Thomas E. Dickey * .\" Copyright 1998,2010 Free Software Foundation, Inc. * .\" * .\" Permission is hereby granted, free of charge, to any person obtaining a * @@ -27,8 +27,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: mitem_visible.3x,v 1.25 2023/11/25 14:18:16 tom Exp $ -.TH mitem_visible 3X 2023-11-25 "ncurses 6.4" "Library calls" +.\" $Id: mitem_visible.3x,v 1.27 2024/03/16 15:35:01 tom Exp $ +.TH mitem_visible 3X 2024-03-16 "ncurses 6.4" "Library calls" .SH NAME \fBitem_visible\fP \- check visibility of a menu item diff --git a/upstream/mageia-cauldron/man3/ncurses.3x b/upstream/mageia-cauldron/man3/ncurses.3x index be4ca538..114eb7ca 100644 --- a/upstream/mageia-cauldron/man3/ncurses.3x +++ b/upstream/mageia-cauldron/man3/ncurses.3x @@ -28,8 +28,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: ncurses.3x,v 1.197 2024/01/13 20:30:39 tom Exp $ -.TH ncurses 3X 2024-01-13 "ncurses 6.4" "Library calls" +.\" $Id: ncurses.3x,v 1.204 2024/03/23 20:42:29 tom Exp $ +.TH ncurses 3X 2024-03-23 "ncurses 6.4" "Library calls" .ie \n(.g \{\ .ds `` \(lq .ds '' \(rq @@ -55,20 +55,49 @@ character-cell terminal interface with optimized output \fB#include <curses.h> .fi .SH DESCRIPTION -The \fI\%ncurses\fP library routines give the user a -terminal-independent method of updating character screens with -reasonable optimization. -This implementation is \*(``new curses\*('' (\fI\%ncurses\fP) and -is the approved replacement for -4.4BSD classic curses, which has been discontinued. +The \*(``new curses\*('' library offers the programmer a +terminal-independent means of reading keyboard and mouse input and +updating character-cell terminals with output optimized to minimize +screen updates. +.I \%ncurses +replaces the +.I curses +libraries from +System V Release 4 Unix (\*(``SVr4\*('') +and +4.4BSD Unix, +the development of which ceased in the 1990s. This describes \fI\%ncurses\fP -version 6.4 (patch 20240217). +version 6.4 (patch 20240323). +.PP +.I \%ncurses +permits control of the terminal screen's contents; +abstraction and subdivision thereof with +.I windows +and +.IR pads ; +the reading of terminal input; +control of terminal input and output options; +environment query routines; +color manipulation; +the definition and use of +.I "soft label" +keys; +.I \%term\%info +capabilities; +a +.I \%term\%cap +compatibility interface; +and access to low-level terminal-manipulation routines. .PP -The \fI\%ncurses\fP library emulates the curses library of -System V Release 4 Unix (\*(``SVr4\*(''), -and XPG4 (X/Open Portability Guide) curses (also known as XSI curses). -XSI stands for X/Open System Interfaces Extension. -The \fI\%ncurses\fP library is freely redistributable in source form. +.I \%ncurses +implements the standard interface described by +X/Open Curses Issue\ 7. +In many behavioral details not standardized by X/Open, +.I \%ncurses +emulates the +.I curses +library of SVr4 and provides numerous useful extensions. .PP \fI\%ncurses\fP man pages employ several sections to clarify matters of usage and interoperability with other \fIcurses\fP implementations. @@ -107,12 +136,6 @@ The ncurses_g library generates trace logs (in a file called \*(``trace\*('' in the current directory) that describe curses actions. See section \*(``ALTERNATE CONFIGURATIONS\*('' below. -.PP -The \fI\%ncurses\fP package supports: overall screen, window and pad -manipulation; output to windows and pads; reading terminal input; control over -terminal and \fBcurses\fP input and output options; environment query -routines; color manipulation; use of soft label keys; terminfo capabilities; -and access to low-level terminal-manipulation routines. .SS Initialization The library uses the locale which the calling program has initialized. That is normally done with \fBsetlocale\fP(3): @@ -127,7 +150,7 @@ If the locale is not initialized, the library assumes that characters are printable as in ISO\-8859\-1, to work with certain legacy programs. You should initialize the locale and not rely on specific details of -the library when the locale has not been setup. +the library when the locale has not been set up. .PP The function \fBinitscr\fP or \fBnewterm\fP must be called to initialize the library @@ -205,7 +228,7 @@ window-addressing functions feature names prefixed see below) with \*(``w\*(''; these allow the user to specify a pointer to a -.I \%WINDOW. +.IR \%WINDOW . Counterparts not thus prefixed (or infixed) affect \fB\%stdscr\fP. @@ -360,7 +383,7 @@ It stores a character combined with attributes in a .I \%chtype datum, which is often an alias of -.I int. +.IR int . .IP Attributes alone (with no corresponding character) @@ -375,7 +398,7 @@ they are represented as an integral bit mask. Each cell of a .I \%WINDOW is stored as a -.I \%chtype. +.IR \%chtype . .TP 10 .I \%ncursesw is the library in its \*(``wide\*('' configuration, @@ -391,27 +414,27 @@ characters. .TP 9 \" "cchar_t" + 2n .I \%cchar_t corresponds to the non-wide configuration's -.I \%chtype. +.IR \%chtype . It always a structure type, because it stores more data than fits into an integral type. A character code may not be representable as a -.I \%char, +.IR \%char , and moreover more than one character may occupy a cell (as with accent marks and other diacritics). Each character is of type -.I \%wchar_t; +.IR \%wchar_t ; a complex character contains one spacing character and zero or more non-spacing characters (see below). Attributes and color data are stored in separate fields of the structure, not combined as in -.I \%chtype. +.IR \%chtype . .PP Each cell of a .I \%WINDOW is stored as a -.I \%cchar_t. +.IR \%cchar_t . .PP The \fB\%setcchar\fP(3X) and \fB\%getcchar\fP(3X) functions store and retrieve the data from a @@ -424,16 +447,16 @@ depends on two data types standardized by ISO C95. .I \%wchar_t stores a wide character. Like -.I \%chtype, +.IR \%chtype , it may be an alias of -.I int. +.IR int . Depending on the character encoding, a wide character may be -.I spacing, +.IR spacing , meaning that it occupies a character cell by itself and typically accompanies cursor advancement, or -.I non-spacing, +.IR non-spacing , meaning that it occupies the same cell as a spacing character, is often regarded as a \*(``modifier\*('' of the base glyph with which it combines, @@ -986,15 +1009,16 @@ character. .SS "\fIBAUDRATE\fP" The debugging library checks this environment variable when the application has redirected output to a file. -The variable's numeric value is used for the baudrate. +The variable's numeric value is used for the baud rate. If no value is found, \fI\%ncurses\fP uses 9600. This allows testers to construct repeatable test-cases -that take into account costs that depend on baudrate. +that take into account costs that depend on baud rate. .SS "\fICOLUMNS\fP" Specify the width of the screen in characters. Applications running in a windowing environment usually are able to obtain the width of the window in which they are executing. -If neither the \fI\%COLUMNS\fP value nor the terminal's screen size is available, +If neither the \fI\%COLUMNS\fP value +nor the terminal's screen size is available, \fI\%ncurses\fP uses the size which may be specified in the terminfo database (i.e., the \fBcols\fP capability). @@ -1210,7 +1234,7 @@ For example # VT100 shift\-in/shift\-out, with corresponding font. linux\-vt100|linux console with VT100 line\-graphics, U8#0, use=linux, - +\& # uxterm with vt100Graphics resource set to false xterm\-utf8|xterm relying on UTF\-8 line\-graphics, U8#1, use=xterm, @@ -1394,7 +1418,7 @@ Run the script with the option to peruse them all. A few are of particular significance to the application developer employing -.I \%ncurses. +.IR \%ncurses . .TP 5 \-\-disable\-overwrite The standard include for \fI\%ncurses\fP is as noted in \fBSYNOPSIS\fP: @@ -1568,13 +1592,13 @@ inclusion of \fI\%curses.h\fP. .I \%ncurses enables an application to capture mouse events on certain terminals, including -.I \%xterm; +.IR \%xterm ; see \fB\%curs_mouse\fP(3X). .PP .I \%ncurses provides a means of responding to window resizing events, as when running in a GUI terminal emulator application such as -.I \%xterm; +.IR \%xterm ; see \fB\%resizeterm\fP(3X) and \fB\%wresize\fP(3X). .PP .I \%ncurses @@ -1641,7 +1665,7 @@ causes the library to fall back to reading if the terminal setup code cannot find a .I \%term\%info entry corresponding to -.I TERM. +.IR TERM . Use of this feature is not recommended, as it essentially includes an entire .I termcap diff --git a/upstream/mageia-cauldron/man3/new_pair.3x b/upstream/mageia-cauldron/man3/new_pair.3x index 6aa948f7..5243f8bf 100644 --- a/upstream/mageia-cauldron/man3/new_pair.3x +++ b/upstream/mageia-cauldron/man3/new_pair.3x @@ -1,5 +1,5 @@ .\"*************************************************************************** -.\" Copyright 2018-2022,2023 Thomas E. Dickey * +.\" Copyright 2018-2023,2024 Thomas E. Dickey * .\" Copyright 2017 Free Software Foundation, Inc. * .\" * .\" Permission is hereby granted, free of charge, to any person obtaining a * @@ -29,8 +29,8 @@ .\" .\" Author: Thomas E. Dickey .\" -.\" $Id: new_pair.3x,v 1.44 2023/12/16 20:32:22 tom Exp $ -.TH new_pair 3X 2023-12-16 "ncurses 6.4" "Library calls" +.\" $Id: new_pair.3x,v 1.46 2024/03/16 15:35:01 tom Exp $ +.TH new_pair 3X 2024-03-16 "ncurses 6.4" "Library calls" .ie \n(.g \{\ .ds `` \(lq .ds '' \(rq diff --git a/upstream/mageia-cauldron/man3/panel.3x b/upstream/mageia-cauldron/man3/panel.3x index 9f4bf26f..6c433b5e 100644 --- a/upstream/mageia-cauldron/man3/panel.3x +++ b/upstream/mageia-cauldron/man3/panel.3x @@ -1,5 +1,5 @@ .\"*************************************************************************** -.\" Copyright 2018-2022,2023 Thomas E. Dickey * +.\" Copyright 2018-2023,2024 Thomas E. Dickey * .\" Copyright 1998-2016,2017 Free Software Foundation, Inc. * .\" * .\" Permission is hereby granted, free of charge, to any person obtaining a * @@ -27,8 +27,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: panel.3x,v 1.61 2023/12/23 16:22:25 tom Exp $ -.TH panel 3X 2023-12-23 "ncurses 6.4" "Library calls" +.\" $Id: panel.3x,v 1.63 2024/03/16 15:35:01 tom Exp $ +.TH panel 3X 2024-03-16 "ncurses 6.4" "Library calls" .ie \n(.g \{\ .ds `` \(lq .ds '' \(rq diff --git a/upstream/mageia-cauldron/man3/resizeterm.3x b/upstream/mageia-cauldron/man3/resizeterm.3x index 9611be60..9d76f311 100644 --- a/upstream/mageia-cauldron/man3/resizeterm.3x +++ b/upstream/mageia-cauldron/man3/resizeterm.3x @@ -1,5 +1,5 @@ .\"*************************************************************************** -.\" Copyright 2018-2022,2023 Thomas E. Dickey * +.\" Copyright 2018-2023,2024 Thomas E. Dickey * .\" Copyright 1998-2015,2017 Free Software Foundation, Inc. * .\" * .\" Permission is hereby granted, free of charge, to any person obtaining a * @@ -29,8 +29,8 @@ .\" .\" Author: Thomas E. Dickey 1996-on .\" -.\" $Id: resizeterm.3x,v 1.54 2023/12/16 20:32:22 tom Exp $ -.TH resizeterm 3X 2023-12-16 "ncurses 6.4" "Library calls" +.\" $Id: resizeterm.3x,v 1.56 2024/03/16 15:35:01 tom Exp $ +.TH resizeterm 3X 2024-03-16 "ncurses 6.4" "Library calls" .de bP .ie n .IP \(bu 4 .el .IP \(bu 2 diff --git a/upstream/mageia-cauldron/man3/sd_bus_error.3 b/upstream/mageia-cauldron/man3/sd_bus_error.3 index dba26b16..5be72f31 100644 --- a/upstream/mageia-cauldron/man3/sd_bus_error.3 +++ b/upstream/mageia-cauldron/man3/sd_bus_error.3 @@ -437,7 +437,7 @@ or unset\&. D\-Bus errors are converted to the integral #include <errno\&.h> #include <string\&.h> #include <unistd\&.h> -#include <sd\-bus\&.h> +#include <systemd/sd\-bus\&.h> int writer_with_negative_errno_return(int fd, sd_bus_error *error) { const char *message = "Hello, World!\en"; diff --git a/upstream/mageia-cauldron/man3/sd_event_add_child.3 b/upstream/mageia-cauldron/man3/sd_event_add_child.3 index 736efa60..ecb70c6c 100644 --- a/upstream/mageia-cauldron/man3/sd_event_add_child.3 +++ b/upstream/mageia-cauldron/man3/sd_event_add_child.3 @@ -268,7 +268,7 @@ from an early phase of the program when no other threads have been started\&. #include <assert\&.h> #include <stdio\&.h> #include <unistd\&.h> -#include <sd\-event\&.h> +#include <systemd/sd\-event\&.h> int main(int argc, char **argv) { pid_t pid = fork(); diff --git a/upstream/mageia-cauldron/man3/sd_event_add_io.3 b/upstream/mageia-cauldron/man3/sd_event_add_io.3 index 4cf99760..dc8d2a73 100644 --- a/upstream/mageia-cauldron/man3/sd_event_add_io.3 +++ b/upstream/mageia-cauldron/man3/sd_event_add_io.3 @@ -169,10 +169,13 @@ retrieves the UNIX file descriptor of an event source created previously with .PP \fBsd_event_source_set_io_fd()\fR changes the UNIX file descriptor of an I/O event source created previously with -\fBsd_event_add_io()\fR\&. It takes the event source object and the new file descriptor\&. +\fBsd_event_add_io()\fR\&. It takes the event source object and the new file descriptor\&. If the event source takes the ownership of the previous file descriptor, that is, +\fBsd_event_source_set_io_fd_own()\fR +was called for the event source with a non\-zero value, then the previous file descriptor will be closed and the event source will also take the ownership of the new file descriptor on success\&. .PP \fBsd_event_source_set_io_fd_own()\fR -controls whether the file descriptor of the event source shall be closed automatically when the event source is freed, i\&.e\&. whether it shall be considered \*(Aqowned\*(Aq by the event source object\&. By default it is not closed automatically, and the application has to do this on its own\&. The +controls whether the file descriptor of the event source shall be closed automatically when the event source is freed (or when the file descriptor assigned to the event source is replaced by +\fBsd_event_source_set_io_fd()\fR), i\&.e\&. whether it shall be considered \*(Aqowned\*(Aq by the event source object\&. By default it is not closed automatically, and the application has to do this on its own\&. The \fIb\fR parameter is a boolean parameter: if zero, the file descriptor is not closed automatically when the event source is freed, otherwise it is closed\&. .PP diff --git a/upstream/mageia-cauldron/man3/sd_hwdb_get.3 b/upstream/mageia-cauldron/man3/sd_hwdb_get.3 index 2a6d51ee..5444f6bd 100644 --- a/upstream/mageia-cauldron/man3/sd_hwdb_get.3 +++ b/upstream/mageia-cauldron/man3/sd_hwdb_get.3 @@ -142,16 +142,16 @@ from an early phase of the program when no other threads have been started\&. #include <stdio\&.h> #include <stdint\&.h> -#include <sd\-hwdb\&.h> +#include <systemd/sd\-hwdb\&.h> int print_usb_properties(uint16_t vid, uint16_t pid) { - char match[STRLEN("usb:vp") + DECIMAL_STR_MAX(uint16_t) * 2]; + char match[128]; sd_hwdb *hwdb; const char *key, *value; int r; /* Match this USB vendor and product ID combination */ - xsprintf(match, "usb:v%04Xp%04X", vid, pid); + snprintf(match, sizeof match, "usb:v%04Xp%04X", vid, pid); r = sd_hwdb_new(&hwdb); if (r < 0) diff --git a/upstream/mageia-cauldron/man3/sd_journal_get_cursor.3 b/upstream/mageia-cauldron/man3/sd_journal_get_cursor.3 index 82d21b07..80eec75f 100644 --- a/upstream/mageia-cauldron/man3/sd_journal_get_cursor.3 +++ b/upstream/mageia-cauldron/man3/sd_journal_get_cursor.3 @@ -41,16 +41,17 @@ returns a cursor string for the current journal entry\&. A cursor is a serializa and should be freed after use with \fBfree\fR(3)\&. .PP +\fBsd_journal_test_cursor()\fR +may be used to check whether the current position in the journal matches the specified cursor\&. This is useful since cursor strings do not uniquely identify an entry: the same entry might be referred to by multiple different cursor strings, and hence string comparing cursors is not possible\&. Use this call to verify after an invocation of +\fBsd_journal_seek_cursor\fR(3), whether the entry being sought to was actually found in the journal or the next closest entry was used instead\&. +.PP Note that \fBsd_journal_get_cursor()\fR +and +\fBsd_journal_test_cursor()\fR will not work before \fBsd_journal_next\fR(3) -(or related call) has been called at least once, in order to position the read pointer at a valid entry\&. -.PP -\fBsd_journal_test_cursor()\fR -may be used to check whether the current position in the journal matches the specified cursor\&. This is useful since cursor strings do not uniquely identify an entry: the same entry might be referred to by multiple different cursor strings, and hence string comparing cursors is not possible\&. Use this call to verify after an invocation of -\fBsd_journal_seek_cursor\fR(3) -whether the entry being sought to was actually found in the journal or the next closest entry was used instead\&. +(or one of the other functions which move to an entry) has been called at least once to position the read pointer at a valid entry\&. .SH "RETURN VALUE" .PP \fBsd_journal_get_cursor()\fR diff --git a/upstream/mageia-cauldron/man3/sd_journal_seek_head.3 b/upstream/mageia-cauldron/man3/sd_journal_seek_head.3 index 08c83b87..90958be7 100644 --- a/upstream/mageia-cauldron/man3/sd_journal_seek_head.3 +++ b/upstream/mageia-cauldron/man3/sd_journal_seek_head.3 @@ -57,8 +57,7 @@ seeks to a position with the specified realtime (wallclock) timestamp, i\&.e\&. .PP \fBsd_journal_seek_cursor()\fR seeks to the position at the specified cursor string\&. For details on cursors, see -\fBsd_journal_get_cursor\fR(3)\&. If no entry matching the specified cursor is found the call will seek to the next closest entry (in terms of time) instead\&. To verify whether the newly selected entry actually matches the cursor, use -\fBsd_journal_test_cursor\fR(3)\&. +\fBsd_journal_get_cursor\fR(3)\&. If no entry matching the specified cursor is found the call will seek to the next closest entry (in terms of time) instead\&. .PP Note that these calls do not actually make any entry the new current entry, this needs to be done in a separate step with a subsequent \fBsd_journal_next\fR(3) @@ -70,6 +69,12 @@ or an entry cursor be retrieved via is used, the closest following entry will be sought to, if \fBsd_journal_previous\fR(3) is used the closest preceding entry is sought to\&. +.PP +After the seek is done, and +\fBsd_journal_next\fR(3) +or a similar call has been made, +\fBsd_journal_test_cursor\fR(3) +may be used to verify whether the newly selected entry actually matches the cursor\&. .SH "RETURN VALUE" .PP The functions return 0 on success or a negative errno\-style error code\&. diff --git a/upstream/mageia-cauldron/man3/sd_notify.3 b/upstream/mageia-cauldron/man3/sd_notify.3 index 204db883..48274b00 100644 --- a/upstream/mageia-cauldron/man3/sd_notify.3 +++ b/upstream/mageia-cauldron/man3/sd_notify.3 @@ -425,6 +425,190 @@ over will be used instead\&. The address should be in the form: "vsock:CID:PORT"\&. Note that unlike other uses of vsock, the CID is mandatory and cannot be "VMADDR_CID_ANY"\&. Note that PID1 will send the VSOCK packets from a privileged port (i\&.e\&.: lower than 1024), as an attempt to address concerns that unprivileged processes in the guest might try to send malicious notifications to the host, driving it to make destructive decisions based on them\&. +.PP +Note that, while using this library should be preferred in order to avoid code duplication, it is also possible to reimplement the simple readiness notification protocol without external dependencies, as demonstrated in the following self\-contained example: +.sp +.if n \{\ +.RS 4 +.\} +.nf +/* SPDX\-License\-Identifier: MIT\-0 */ + +/* Implement the systemd notify protocol without external dependencies\&. + * Supports both readiness notification on startup and on reloading, + * according to the protocol defined at: + * https://www\&.freedesktop\&.org/software/systemd/man/latest/sd_notify\&.html + * This protocol is guaranteed to be stable as per: + * https://systemd\&.io/PORTABILITY_AND_STABILITY/ */ + +#include <errno\&.h> +#include <inttypes\&.h> +#include <signal\&.h> +#include <stdbool\&.h> +#include <stddef\&.h> +#include <stdlib\&.h> +#include <stdio\&.h> +#include <sys/socket\&.h> +#include <sys/un\&.h> +#include <time\&.h> +#include <unistd\&.h> + +#define _cleanup_(f) __attribute__((cleanup(f))) + +static void closep(int *fd) { + if (!fd || *fd < 0) + return; + + close(*fd); + *fd = \-1; +} + +static int notify(const char *message) { + union sockaddr_union { + struct sockaddr sa; + struct sockaddr_un sun; + } socket_addr = { + \&.sun\&.sun_family = AF_UNIX, + }; + size_t path_length, message_length; + _cleanup_(closep) int fd = \-1; + const char *socket_path; + + socket_path = getenv("NOTIFY_SOCKET"); + if (!socket_path) + return 0; /* Not running under systemd? Nothing to do */ + + if (!message) + return \-EINVAL; + + message_length = strlen(message); + if (message_length == 0) + return \-EINVAL; + + /* Only AF_UNIX is supported, with path or abstract sockets */ + if (socket_path[0] != \*(Aq/\*(Aq && socket_path[0] != \*(Aq@\*(Aq) + return \-EAFNOSUPPORT; + + path_length = strlen(socket_path); + /* Ensure there is room for NUL byte */ + if (path_length >= sizeof(socket_addr\&.sun\&.sun_path)) + return \-E2BIG; + + memcpy(socket_addr\&.sun\&.sun_path, socket_path, path_length); + + /* Support for abstract socket */ + if (socket_addr\&.sun\&.sun_path[0] == \*(Aq@\*(Aq) + socket_addr\&.sun\&.sun_path[0] = 0; + + fd = socket(AF_UNIX, SOCK_DGRAM|SOCK_CLOEXEC, 0); + if (fd < 0) + return \-errno; + + if (connect(fd, &socket_addr\&.sa, offsetof(struct sockaddr_un, sun_path) + path_length) != 0) + return \-errno; + + ssize_t written = write(fd, message, message_length); + if (written != (ssize_t) message_length) + return written < 0 ? \-errno : \-EPROTO; + + return 1; /* Notified! */ +} + +static int notify_ready(void) { + return notify("READY=1"); +} + +static int notify_reloading(void) { + /* A buffer with length sufficient to format the maximum UINT64 value\&. */ + char reload_message[sizeof("RELOADING=1\enMONOTONIC_USEC=18446744073709551615")]; + struct timespec ts; + uint64_t now; + + /* Notify systemd that we are reloading, including a CLOCK_MONOTONIC timestamp in usec + * so that the program is compatible with a Type=notify\-reload service\&. */ + + if (clock_gettime(CLOCK_MONOTONIC, &ts) < 0) + return \-errno; + + if (ts\&.tv_sec < 0 || ts\&.tv_nsec < 0 || + (uint64_t) ts\&.tv_sec > (UINT64_MAX \- (ts\&.tv_nsec / 1000ULL)) / 1000000ULL) + return \-EINVAL; + + now = (uint64_t) ts\&.tv_sec * 1000000ULL + (uint64_t) ts\&.tv_nsec / 1000ULL; + + if (snprintf(reload_message, sizeof(reload_message), "RELOADING=1\enMONOTONIC_USEC=%" PRIu64, now) < 0) + return \-EINVAL; + + return notify(reload_message); +} + +static volatile sig_atomic_t reloading = 0; +static volatile sig_atomic_t terminating = 0; + +static void signal_handler(int sig) { + if (sig == SIGHUP) + reloading = 1; + else if (sig == SIGINT || sig == SIGTERM) + terminating = 1; +} + +int main(int argc, char **argv) { + struct sigaction sa = { + \&.sa_handler = signal_handler, + \&.sa_flags = SA_RESTART, + }; + int r; + + /* Setup signal handlers */ + sigemptyset(&sa\&.sa_mask); + sigaction(SIGHUP, &sa, NULL); + sigaction(SIGINT, &sa, NULL); + sigaction(SIGTERM, &sa, NULL); + + /* Do more service initialization work here \&... */ + + /* Now that all the preparations steps are done, signal readiness */ + + r = notify_ready(); + if (r < 0) { + fprintf(stderr, "Failed to notify readiness to $NOTIFY_SOCKET: %s\en", strerror(\-r)); + return EXIT_FAILURE; + } + + while (!terminating) { + if (reloading) { + reloading = false; + + /* As a separate but related feature, we can also notify the manager + * when reloading configuration\&. This allows accurate state\-tracking, + * and also automated hook\-in of \*(Aqsystemctl reload\*(Aq without having to + * specify manually an ExecReload= line in the unit file\&. */ + + r = notify_reloading(); + if (r < 0) { + fprintf(stderr, "Failed to notify reloading to $NOTIFY_SOCKET: %s\en", strerror(\-r)); + return EXIT_FAILURE; + } + + /* Do some reconfiguration work here \&... */ + + r = notify_ready(); + if (r < 0) { + fprintf(stderr, "Failed to notify readiness to $NOTIFY_SOCKET: %s\en", strerror(\-r)); + return EXIT_FAILURE; + } + } + + /* Do some daemon work here \&... */ + sleep(5); + } + + return EXIT_SUCCESS; +} +.fi +.if n \{\ +.RE +.\} .SH "ENVIRONMENT" .PP \fI$NOTIFY_SOCKET\fR diff --git a/upstream/mageia-cauldron/man3/sd_path_lookup.3 b/upstream/mageia-cauldron/man3/sd_path_lookup.3 index 7b5b0515..22b15c1a 100644 --- a/upstream/mageia-cauldron/man3/sd_path_lookup.3 +++ b/upstream/mageia-cauldron/man3/sd_path_lookup.3 @@ -210,7 +210,7 @@ Added in version 246\&. #include <stdio\&.h> #include <stdlib\&.h> -#include <sd\-path\&.h> +#include <systemd/sd\-path\&.h> int main(void) { int r; diff --git a/upstream/mageia-cauldron/man3/term_variables.3x b/upstream/mageia-cauldron/man3/term_variables.3x index 85021d78..22d2c755 100644 --- a/upstream/mageia-cauldron/man3/term_variables.3x +++ b/upstream/mageia-cauldron/man3/term_variables.3x @@ -1,5 +1,5 @@ .\"*************************************************************************** -.\" Copyright 2019-2022,2023 Thomas E. Dickey * +.\" Copyright 2019-2023,2024 Thomas E. Dickey * .\" Copyright 2010-2015,2017 Free Software Foundation, Inc. * .\" * .\" Permission is hereby granted, free of charge, to any person obtaining a * @@ -27,8 +27,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: term_variables.3x,v 1.34 2023/12/23 16:08:25 tom Exp $ -.TH term_variables 3X 2023-12-23 "ncurses 6.4" "Library calls" +.\" $Id: term_variables.3x,v 1.36 2024/03/16 15:35:01 tom Exp $ +.TH term_variables 3X 2024-03-16 "ncurses 6.4" "Library calls" .ie \n(.g \{\ .ds `` \(lq .ds '' \(rq diff --git a/upstream/mageia-cauldron/man3/wresize.3x b/upstream/mageia-cauldron/man3/wresize.3x index 6990a38c..f4e8072e 100644 --- a/upstream/mageia-cauldron/man3/wresize.3x +++ b/upstream/mageia-cauldron/man3/wresize.3x @@ -1,5 +1,5 @@ .\"*************************************************************************** -.\" Copyright 2018-2022,2023 Thomas E. Dickey * +.\" Copyright 2018-2023,2024 Thomas E. Dickey * .\" Copyright 1998-2010,2015 Free Software Foundation, Inc. * .\" * .\" Permission is hereby granted, free of charge, to any person obtaining a * @@ -29,8 +29,8 @@ .\" .\" Author: Thomas E. Dickey 1996 .\" -.\" $Id: wresize.3x,v 1.34 2023/11/25 14:26:30 tom Exp $ -.TH wresize 3X 2023-11-25 "ncurses 6.4" "Library calls" +.\" $Id: wresize.3x,v 1.36 2024/03/16 15:35:01 tom Exp $ +.TH wresize 3X 2024-03-16 "ncurses 6.4" "Library calls" .SH NAME \fB\%wresize\fP \- resize a \fIcurses\fR window |