X-Git-Url: https://ncurses.scripts.mit.edu/?a=blobdiff_plain;f=doc%2Fhtml%2Fman%2Fuser_caps.5.html;h=61e2de806db4b111bc90bb98b8379425299ad373;hb=e2153a14ebfb90265151d608778aaf9f403b3d24;hp=4fa5bd0a2ec39e08074b35ee6d23c439399deac8;hpb=67327e4e3b2121f8273fb73ec14ef234ed01231e;p=ncurses.git diff --git a/doc/html/man/user_caps.5.html b/doc/html/man/user_caps.5.html index 4fa5bd0a..61e2de80 100644 --- a/doc/html/man/user_caps.5.html +++ b/doc/html/man/user_caps.5.html @@ -1,7 +1,7 @@
-user_caps(5) File formats user_caps(5) @@ -62,8 +62,8 @@
Before ncurses 5.0, terminfo databases used a fixed repertoire of terminal capabilities designed for the SVr2 terminal database in 1984, - and extended in stages through SVr4 (1989), and standardized in the - Single Unix Specification beginning in 1995. + and extended in stages through SVr4 (1989), and standardized in X/Open + Curses starting in 1995. Most of the extensions in this fixed repertoire were additions to the tables of Boolean, numeric and string capabilities. Rather than change @@ -325,21 +325,28 @@ Applications can use the naming convention established for xterm to find these special keys in the terminal description. - Starting with the curses convention that key names begin with "k" and - that shifted special keys are an uppercase name, ncurses' terminal - database defines these names to which a suffix is added: - - Name Description - --------------------------------------------------------------- - kDC special form of kdch1 (delete character) - kDN special form of kcud1 (cursor down) - kEND special form of kend (End) - kHOM special form of khome (Home) - kLFT special form of kcub1 (cursor-left or cursor-back) - kNXT special form of knext (Next, or Page-Down) - kPRV special form of kprev (Prev, or Page-Up) - kRIT special form of kcuf1 (cursor-right, or cursor-forward) - kUP special form of kcuu1 (cursor-up) + Starting with the curses convention that capability codes describing + the input generated by a terminal's key caps begin with "k", and that + shifted special keys use uppercase letters in their names, ncurses's + terminal database defines the following names and codes to which a + suffix is added. + + Code Description + ------------------------------------------------------------------- + kDC shifted kdch1 (delete character) + kDN shifted kcud1 (cursor down) + kEND shifted kend (end) + kHOM shifted khome (home) + kLFT shifted kcub1 (cursor back) + kNXT shifted knext (next) + kPRV shifted kprev (previous) + kRIT shifted kcuf1 (cursor forward) + kUP shifted kcuu1 (cursor up) + + Keycap nomenclature on the Unix systems for which curses was developed + differs from today's ubiquitous descendants of the IBM PC/AT keyboard + layout. In the foregoing, interpret "backward" as "left", "forward" as + "right", "next" as "page down", and "prev(ious)" as "page up". These are the suffixes used to denote the modifiers: @@ -361,20 +368,20 @@ 15 Meta + Ctrl + Alt 16 Meta + Ctrl + Alt + Shift - None of these are predefined; terminal descriptions can refer to names + None of these are predefined; terminal descriptions can refer to names which ncurses will allocate at runtime to key-codes. To use these keys in an ncurses program, an application could do this: - o using a list of extended key names, ask tigetstr(3x) for their + o using a list of extended key names, ask tigetstr(3x) for their values, and - o given the list of values, ask key_defined(3x) for the key-code + o given the list of values, ask key_defined(3x) for the key-code which would be returned for those keys by wgetch(3x).
- The "-x" extension feature of tic and infocmp has been adopted in - NetBSD curses. That implementation stores user-defined capabilities, + The "-x" extension feature of tic and infocmp has been adopted in + NetBSD curses. That implementation stores user-defined capabilities, but makes no use of these capabilities itself. @@ -387,16 +394,16 @@ infocmp(1m), tic(1m) The terminal database section NCURSES USER-DEFINABLE CAPABILITIES - summarizes commonly-used user-defined capabilities which are used in - the terminal descriptions. Some of those features are mentioned in + summarizes commonly-used user-defined capabilities which are used in + the terminal descriptions. Some of those features are mentioned in screen(1) or tmux(1). - XTerm Control Sequences provides further information on the xterm(1) + XTerm Control Sequences provides further information on the xterm(1) features that are used in these extended capabilities. -ncurses 6.4 2023-12-30 user_caps(5) +ncurses 6.5 2024-06-08 user_caps(5)