--- 2023-10-01.man 2023-10-05 17:55:41.892511072 -0500 +++ gbr3.man 2023-10-05 23:59:54.250719970 -0500 @@ -285,8 +285,8 @@ printf '\033[3J' - “XTerm Control Sequences” documents this feature as originating - with xterm. + instead. “XTerm Control Sequences” documents this feature as + originating with xterm. • A few other terminal emulators adopted it, such as PuTTY in 2006. @@ -632,7 +632,7 @@ For example, this prints the compiled terminfo value as a string which could be assigned to the TERMINFO environment variable: - infocmp ‐0 ‐q ‐Q2 + infocmp -0 -q -Q2 -q This makes the output a little shorter: @@ -928,7 +928,7 @@ Before running curses programs, you should either reset tab‐stops to the standard interval - tabs ‐8 + tabs -8 or use the reset program, since the normal initialization sequences do not ensure that tab‐stops are reset. @@ -1898,7 +1898,7 @@ tput -T450 cols Print the number of columns for the 450 terminal. - bold=‘tput smso‘ offbold=‘tput rmso‘ + bold=`tput smso` offbold=`tput rmso` Set the shell variables bold, to begin stand‐out mode sequence, and offbold, to end standout mode sequence, for the current terminal. This might be followed by a prompt: echo "${bold}Please @@ -2292,7 +2292,7 @@ The arguments for the -e, -i, and -k options may either be entered as actual characters or by using the “hat” notation, i.e., control‐h may - be specified as “ˆH” or “ˆh”. + be specified as “^H” or “^h”. If neither -c or -w is given, both options are assumed. @@ -2494,13 +2494,13 @@ SYNOPSIS #include  - int add_wch( const cchar_t *wch ); - int wadd_wch( WINDOW *win, const cchar_t *wch ); - int mvadd_wch( int y, int x, const cchar_t *wch ); - int mvwadd_wch( WINDOW *win, int y, int x, const cchar_t *wch ); + int add_wch(const cchar_t *wch); + int wadd_wch(WINDOW *win, const cchar_t *wch); + int mvadd_wch(int y, int x, const cchar_t *wch); + int mvwadd_wch(WINDOW *win, int y, int x, const cchar_t *wch); - int echo_wchar( const cchar_t *wch ); - int wecho_wchar( WINDOW *win, const cchar_t *wch ); + int echo_wchar(const cchar_t *wch); + int wecho_wchar(WINDOW *win, const cchar_t *wch); DESCRIPTION add_wch @@ -2556,7 +2556,7 @@ WACS_CKBOARD 0x2592 : a checker board (stipple) WACS_DARROW 0x2193 v . arrow pointing down WACS_DEGREE 0x00b0 ’ f degree symbol - WACS_DIAMOND 0x25c6 + ‘ diamond + WACS_DIAMOND 0x25c6 + ` diamond WACS_GEQUAL 0x2265 > > greater‐than‐or‐equal‐to WACS_HLINE 0x2500 - q horizontal line WACS_LANTERN 0x2603 # i lantern symbol @@ -2915,7 +2915,7 @@ ACS_CKBOARD : a checker board (stipple) ACS_DARROW v . arrow pointing down ACS_DEGREE ’ f degree symbol - ACS_DIAMOND + ‘ diamond + ACS_DIAMOND + ` diamond ACS_GEQUAL > > greater‐than‐or‐equal‐to ACS_HLINE - q horizontal line ACS_LANTERN # i lantern symbol @@ -3148,7 +3148,7 @@ int mvaddstr(int y, int x, const char *str); int mvaddnstr(int y, int x, const char *str, int n); int mvwaddstr(WINDOW *win, int y, int x, const char *str); - int mvwaddnstr(WINDOW *win, int y, int x, const char *str, int n); + int mvwaddnstr(WINDOW *win, int y, int x, const char *str, int n); DESCRIPTION These functions write the (null‐terminated) character string str on the @@ -3819,7 +3819,7 @@ #include  void bkgdset(chtype ch); - void wbkgdset(WINDOW *win, chtype ch); + void wbkgdset(WINDOW *win, chtype ch); int bkgd(chtype ch); int wbkgd(WINDOW *win, chtype ch); @@ -3947,7 +3947,7 @@ int bkgrnd(const cchar_t *wch); int wbkgrnd(WINDOW *win, const cchar_t *wch); - void bkgrndset(const cchar_t *wch ); + void bkgrndset(const cchar_t *wch); void wbkgrndset(WINDOW *win, const cchar_t *wch); int getbkgrnd(cchar_t *wch); @@ -4124,7 +4124,7 @@ const cchar_t *ls, const cchar_t *rs, const cchar_t *ts, const cchar_t *bs, const cchar_t *tl, const cchar_t *tr, - const cchar_t *bl, const cchar_t *br ); + const cchar_t *bl, const cchar_t *br); int wborder_set( WINDOW *win, const cchar_t *ls, const cchar_t *rs, @@ -6357,7 +6357,7 @@ FIELDTYPE *field_type(const FIELD *field); int set_field_type(FIELD *field, FIELDTYPE *type, ...); - /* predefined field types */ + /* predefined field types */ FIELDTYPE *TYPE_ALNUM; FIELDTYPE *TYPE_ALPHA; FIELDTYPE *TYPE_ENUM; @@ -7348,7 +7348,7 @@ int ungetch(int ch); - /* extension */ + /* extension */ int has_key(int ch); DESCRIPTION @@ -8000,17 +8000,17 @@ SYNOPSIS #include  - int set_item_init(MENU *menu, Menu_Hook func); - Menu_Hook item_init(const MENU *menu); + int set_item_init(MENU *menu, Menu_Hook func); + Menu_Hook item_init(const MENU *menu); - int set_item_term(MENU *menu, Menu_Hook func); - Menu_Hook item_term(const MENU *menu); + int set_item_term(MENU *menu, Menu_Hook func); + Menu_Hook item_term(const MENU *menu); - int set_menu_init(MENU *menu, Menu_Hook func); - Menu_Hook menu_init(const MENU *menu); + int set_menu_init(MENU *menu, Menu_Hook func); + Menu_Hook menu_init(const MENU *menu); - int set_menu_term(MENU *menu, Menu_Hook func); - Menu_Hook menu_term(const MENU *menu); + int set_menu_term(MENU *menu, Menu_Hook func); + Menu_Hook menu_term(const MENU *menu); DESCRIPTION These functions make it possible to set hook functions to be called at @@ -8122,7 +8122,7 @@ int mvin_wchstr(int y, int x, cchar_t *wchstr); int mvin_wchnstr(int y, int x, cchar_t *wchstr, int n); int mvwin_wchstr(WINDOW *win, int y, int x, cchar_t *wchstr); - int mvwin_wchnstr(WINDOW *win, int y, int x, cchar_t *wchstr, int n); + int mvwin_wchnstr(WINDOW *win, int y, int x, cchar_t *wchstr, int n); DESCRIPTION These functions return an array of complex characters in wchstr, @@ -11490,12 +11490,12 @@ can be compiled using tic -x. For example # linux console, if patched to provide working - # VT100 shift‐in/shift‐out, with corresponding font. - linux‐vt100|linux console with VT100 line‐graphics, + # 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, + xterm-utf8|xterm relying on UTF-8 line-graphics, U8#1, use=xterm, The name “U8” is chosen to be two characters, to permit it to be used @@ -11576,7 +11576,7 @@ the remainder of that variable as a compiled terminal description. You might produce the base64 format using infocmp(1): - TERMINFO="$(infocmp ‐0 ‐Q2 ‐q)" + TERMINFO="$(infocmp -0 -Q2 -q)" export TERMINFO The compiled description is used if it corresponds to the terminal @@ -12936,8 +12936,6 @@ SYNOPSIS #include  - cc [flags] sourcefiles -lpanel -lncurses - PANEL *new_panel(WINDOW *win); int bottom_panel(PANEL *pan); @@ -12959,7 +12957,7 @@ int del_panel(PANEL *pan); - /* ncurses‐extensions */ + /* ncurses extensions */ PANEL *ground_panel(SCREEN *sp); PANEL *ceiling_panel(SCREEN *sp); @@ -13389,7 +13387,7 @@ int mvwprintw(WINDOW *win, int y, int x, const char *fmt, ...); int vw_printw(WINDOW *win, const char *fmt, va_list varglist); - /* obsolete */ + /* obsolete */ int vwprintw(WINDOW *win, const char *fmt, va_list varglist); DESCRIPTION @@ -13812,7 +13810,7 @@ int vw_scanw(WINDOW *win, const char *fmt, va_list varglist); - /* obsolete */ + /* obsolete */ int vwscanw(WINDOW *win, const char *fmt, va_list varglist); DESCRIPTION @@ -14328,7 +14326,7 @@ int flushinp_sp(SCREEN* sp); int free_pair_sp(SCREEN* sp, int pair); int get_escdelay_sp(SCREEN* sp); - int getmouse_sp(SCREEN* sp, MEVENT* event); + int getmouse_sp(SCREEN* sp, MEVENT* event); WINDOW* getwin_sp(SCREEN* sp, FILE* filep); int halfdelay_sp(SCREEN* sp, int tenths); bool has_colors_sp(SCREEN* sp); @@ -14415,7 +14413,7 @@ int typeahead_sp(SCREEN* sp, int fd); int unget_wch_sp(SCREEN* sp, const wchar_t wch); int ungetch_sp(SCREEN* sp, int ch); - int ungetmouse_sp(SCREEN* sp,MEVENT * event); + int ungetmouse_sp(SCREEN* sp, MEVENT* event); int use_default_colors_sp(SCREEN* sp); void use_env_sp(SCREEN* sp, bool bf); int use_legacy_coding_sp(SCREEN* sp, int level); @@ -14456,7 +14454,7 @@ int tigetnum_sp(SCREEN* sp, const char *capname); char* tigetstr_sp(SCREEN* sp, const char *capname); - /* may instead use 9 long parameters */ + /* may instead use 9 long parameters */ char* tparm_sp(SCREEN* sp, const char *str, ...); int tputs_sp(SCREEN* sp, const char *str, int affcnt, NCURSES_SP_OUTC putc); @@ -15033,7 +15031,7 @@ int vid_puts(attr_t attrs, short pair, void *opts, int (*putc)(int)); int vid_attr(attr_t attrs, short pair, void *opts); - int mvcur(int oldrow, int oldcol, int newrow, int newcol); + int mvcur(int oldrow, int oldcol, int newrow, int newcol); int tigetflag(const char *capname); int tigetnum(const char *capname); @@ -15698,7 +15696,7 @@ terminfo capability long name. These are in terms of the symbol CUR, which is defined - #define CUR ((TERMTYPE *)(cur_term))‐> + #define CUR ((TERMTYPE *)(cur_term))-> These symbols provide a faster method of accessing terminfo capabilities than using tigetstr(3X), etc. @@ -16397,7 +16395,7 @@ char *_nc_tracebits(void); char *_tracemouse(const MEVENT *event); - /* deprecated */ + /* deprecated */ void trace(const unsigned int param); DESCRIPTION @@ -17050,7 +17048,7 @@ int set_menu_sub(MENU *menu, WINDOW *sub); WINDOW *menu_sub(const MENU *menu); - int scale_menu(const MENU *menu, int *rows, int *columns); + int scale_menu(const MENU *menu, int *rows, int *columns); DESCRIPTION Every menu has an associated pair of curses windows. The menu window @@ -17481,7 +17479,7 @@ big‐endian hardware, the magic number is written with the high‐order byte first, e.g., - 01 35 + \001\035 After the magic number, the WINDOW structure and line‐data are written in binary format. While the magic number used by the Unix systems can @@ -17654,7 +17652,7 @@ On the other hand, the SVr4 curses library does know about the background color. However, its screen dumps are in binary. Here is - the corresponding dump (using “od ‐t x1”): + the corresponding dump (using “od -t x1”): 0000000 1c 01 c3 d6 f3 58 05 00 0b 00 0a 00 14 00 00 00 0000020 00 00 02 00 00 00 00 00 00 00 00 00 00 00 00 00 @@ -17823,7 +17821,7 @@ The string table is the last section. It contains all of the values of string capabilities referenced in the strings section. Each string is - null‐terminated. Special characters in ˆX or \c notation are stored in + null‐terminated. Special characters in ^X or \c notation are stored in their interpreted form, not the printing representation. Padding information $ and parameter information %x are stored intact in uninterpreted form. @@ -17947,9 +17945,9 @@ adm3a|lsi adm3a, am, cols#80, lines#24, - bel=ˆG, clear= 32$<1>, cr=ˆM, cub1=ˆH, cud1=ˆJ, - cuf1=ˆL, cup=\E=%p1%{32}%+%c%p2%{32}%+%c, cuu1=ˆK, - home=ˆˆ, ind=ˆJ, + bel=^G, clear=\032$<1>, cr=^M, cub1=^H, cud1=^J, + cuf1=^L, cup=\E=%p1%{32}%+%c%p2%{32}%+%c, cuu1=^K, + home=^^, ind=^J, and a hexadecimal dump of the compiled terminal description: @@ -19078,23 +19076,23 @@ representative of what a terminfo entry for a modern terminal typically looks like. - ansi|ansi/pc‐term compatible with color, + ansi|ansi/pc-term compatible with color, am, mc5i, mir, msgr, colors#8, cols#80, it#8, lines#24, ncv#3, pairs#64, - acsc=+\020\,\021‐\030.ˆY0\333‘\004a\261f\370g\361h\260 - j\331k\277l\332m\300n\305o˜p\304q\304r\304s_t\303 - u\264v\301w\302x\263y\363z\362{\343|\330}\234˜\376, - bel=ˆG, blink=\E[5m, bold=\E[1m, cbt=\E[Z, clear=\E[H\E[J, - cr=ˆM, cub=\E[%p1%dD, cub1=\E[D, cud=\E[%p1%dB, cud1=\E[B, + acsc=+\020\,\021-\030.^Y0\333`\004a\261f\370g\361h\260 + j\331k\277l\332m\300n\305o~p\304q\304r\304s_t\303 + u\264v\301w\302x\263y\363z\362{\343|\330}\234~\376, + bel=^G, blink=\E[5m, bold=\E[1m, cbt=\E[Z, clear=\E[H\E[J, + cr=^M, cub=\E[%p1%dD, cub1=\E[D, cud=\E[%p1%dB, cud1=\E[B, cuf=\E[%p1%dC, cuf1=\E[C, cup=\E[%i%p1%d;%p2%dH, cuu=\E[%p1%dA, cuu1=\E[A, dch=\E[%p1%dP, dch1=\E[P, dl=\E[%p1%dM, dl1=\E[M, ech=\E[%p1%dX, ed=\E[J, el=\E[K, el1=\E[1K, home=\E[H, hpa=\E[%i%p1%dG, ht=\E[I, hts=\EH, - ich=\E[%p1%d@, il=\E[%p1%dL, il1=\E[L, ind=ˆJ, - indn=\E[%p1%dS, invis=\E[8m, kbs=ˆH, kcbt=\E[Z, kcub1=\E[D, + ich=\E[%p1%d@, il=\E[%p1%dL, il1=\E[L, ind=^J, + indn=\E[%p1%dS, invis=\E[8m, kbs=^H, kcbt=\E[Z, kcub1=\E[D, kcud1=\E[B, kcuf1=\E[C, kcuu1=\E[A, khome=\E[H, kich1=\E[L, mc4=\E[4i, mc5=\E[5i, nel=\r\E[S, op=\E[39;49m, - rep=%p1%c\E[%p2%{1}%‐%db, rev=\E[7m, rin=\E[%p1%dT, + rep=%p1%c\E[%p2%{1}%-%db, rev=\E[7m, rin=\E[%p1%dT, rmacs=\E[10m, rmpch=\E[10m, rmso=\E[m, rmul=\E[m, s0ds=\E(B, s1ds=\E)B, s2ds=\E*B, s3ds=\E+B, setab=\E[4%p1%dm, setaf=\E[3%p1%dm, @@ -19142,7 +19140,7 @@ • Both \E and \e map to an ESCAPE character, - • ˆx maps to a control‐x for any appropriate x, and + • ^x maps to a control‐x for any appropriate x, and • the sequences @@ -19155,14 +19153,14 @@ respectively. X/Open Curses does not say what “appropriate x” might be. In practice, - that is a printable ASCII graphic character. The special case “ˆ?” is + that is a printable ASCII graphic character. The special case “^?” is interpreted as DEL (127). In all other cases, the character value is AND’d with 0x1f, mapping to ASCII control codes in the range 0 through 31. Other escapes include - • \ˆ for ˆ, + • \^ for ^, • \\ for \, @@ -19332,13 +19330,13 @@ terminals. Thus the model 33 teletype is described as 33|tty33|tty|model 33 teletype, - bel=ˆG, cols#72, cr=ˆM, cud1=ˆJ, hc, ind=ˆJ, os, + bel=^G, cols#72, cr=^M, cud1=^J, hc, ind=^J, os, while the Lear Siegler ADM‐3 is described as adm3|3|lsi adm3, - am, bel=ˆG, clear=ˆZ, cols#80, cr=ˆM, cub1=ˆH, cud1=ˆJ, - ind=ˆJ, lines#24, + am, bel=^G, clear=^Z, cols#80, cr=^M, cub1=^H, cud1=^J, + ind=^J, lines#24, Parameterized Strings Cursor addressing and other strings requiring parameters in the @@ -19366,7 +19364,7 @@ the next character to be a “-” flag, avoiding interpreting “%-” as an operator. - %c print pop() like %c in printf + %c print pop() like %c in printf %s print pop() like %s in printf @@ -19431,7 +19429,7 @@ %+, %-, %*, %/, %m arithmetic (%m is mod): push(pop() op pop()) - %&, %|, %ˆ + %&, %|, %^ bit operations (AND, OR and exclusive‐OR): push(pop() op pop()) %=, %>, %< @@ -19440,7 +19438,7 @@ %A, %O logical AND and OR operations (for conditionals) - %!, %˜ + %!, %~ unary operations (logical and bit complement): push(op pop()) %i add 1 to first two parameters (for ANSI terminals) @@ -19472,12 +19470,12 @@ cup=\E&a%p2%dc%p1%dY$<6>, The Microterm ACT‐IV needs the current row and column sent preceded by - a ˆT, with the row and column simply encoded in binary, - cup=ˆT%p1%c%p2%c + a ^T, with the row and column simply encoded in binary, + cup=^T%p1%c%p2%c Terminals which use “%c” need to be able to backspace the cursor (cub1), and to move the cursor up one line on the screen (cuu1). This - is necessary because it is not always safe to transmit \n ˆD and \r, as + is necessary because it is not always safe to transmit \n ^D and \r, as the system may change or discard them. (The library routines dealing with terminfo set tty modes so that tabs are never expanded, so \t is safe to send. This turns out to be essential for the Ann Arbor 4080.) @@ -19668,7 +19666,7 @@ Yet another way to construct insert and delete might be to use a combination of index with the memory‐lock feature found on some - terminals (like the HP-700/90 series, which however also has + terminals (like the HP‐700/90 series, which however also has insert/delete). Inserting lines at the top or bottom of the screen can also be done @@ -19819,16 +19817,16 @@ p6 bold \E[0;1m p7 invis \E[0;8m p8 protect not used - p9 altcharset ˆO (off) ˆN (on) + p9 altcharset ^O (off) ^N (on) We begin each escape sequence by turning off any existing modes, since there is no quick way to determine whether they are active. Standout is set up to be the combination of reverse and bold. The vt220 terminal has a protect mode, though it is not commonly used in sgr because it protects characters on the screen from the host’s erasures. - The altcharset mode also is different in that it is either ˆO or ˆN, + The altcharset mode also is different in that it is either ^O or ^N, depending on whether it is off or on. If all modes are turned on, the - resulting sequence is \E[0;1;4;5;7;8mˆN. + resulting sequence is \E[0;1;4;5;7;8m^N. Some sequences are common to different modes. For example, ;7 is output when either p1 or p3 is true, that is, if either standout or @@ -20072,7 +20070,7 @@ characters after certain cursor motions and screen changes. If the terminal uses xon/xoff handshaking for flow control (that is, it - automatically emits ˆS back to the host when its input buffers are + automatically emits ^S back to the host when its input buffers are close to full), set xon. This capability suppresses the emission of padding. You can also set it for memory‐mapped console devices effectively that do not have a speed limit. Padding information should @@ -20132,7 +20130,7 @@ arrow pointing up ACS_UARROW ^ - 0x2d arrow pointing down ACS_DARROW v . 0x2e solid square block ACS_BLOCK # 0 0x30 - diamond ACS_DIAMOND + ‘ 0x60 + diamond ACS_DIAMOND + ` 0x60 checker board (stipple) ACS_CKBOARD : a 0x61 degree symbol ACS_DEGREE \ f 0x66 plus/minus ACS_PLMINUS # g 0x67 @@ -20380,7 +20378,7 @@ while an mc5p is in effect. Glitches and Braindamage - Hazeltine terminals, which do not allow “˜” characters to be displayed + Hazeltine terminals, which do not allow “~” characters to be displayed should indicate hz. Terminals which ignore a line‐feed immediately after an am wrap, such @@ -20571,7 +20569,9 @@ user_caps - user‐defined terminfo capability format SYNOPSIS - tic ‐x, infocmp ‐x + infocmp -x + + tic -x DESCRIPTION Background