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 2023-12-30 ncurses 6.4 File formats +user_caps 5 2024-06-08 ncurses 6.5 File formats -

user_caps 5 2023-12-30 ncurses 6.4 File formats

+

user_caps 5 2024-06-08 ncurses 6.5 File formats

 user_caps(5)                     File formats                     user_caps(5)
 
@@ -62,8 +62,8 @@
 

Background

        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).
 
 
 

PORTABILITY

-       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)