curses 1.3.0 → 1.4.2

data/vendor/PDCurses/dos/pdcsetsc.c

@@ -0,0 +1,101 @@
+/* Public Domain Curses */
+
+#include "pdcdos.h"
+
+/*man-start**************************************************************
+
+pdcsetsc
+--------
+
+### Synopsis
+
+    int PDC_set_blink(bool blinkon);
+    void PDC_set_title(const char *title);
+
+### Description
+
+   PDC_set_blink() toggles whether the A_BLINK attribute sets an
+   actual blink mode (TRUE), or sets the background color to high
+   intensity (FALSE). The default is platform-dependent (FALSE in
+   most cases). It returns OK if it could set the state to match
+   the given parameter, ERR otherwise. Current platforms also
+   adjust the value of COLORS according to this function -- 16 for
+   FALSE, and 8 for TRUE.
+
+   PDC_set_title() sets the title of the window in which the curses
+   program is running. This function may not do anything on some
+   platforms. (Currently it only works in Win32 and X11.)
+
+### Portability
+                             X/Open    BSD    SYS V
+    PDC_set_blink               -       -       -
+    PDC_set_title               -       -       -
+
+**man-end****************************************************************/
+
+int PDC_curs_set(int visibility)
+{
+    PDCREGS regs;
+    int ret_vis, start, end;
+
+    PDC_LOG(("PDC_curs_set() - called: visibility=%d\n", visibility));
+
+    ret_vis = SP->visibility;
+    SP->visibility = visibility;
+
+    switch (visibility)
+    {
+        case 0:  /* invisible */
+            start = 32;
+            end = 0;  /* was 32 */
+            break;
+        case 2:  /* highly visible */
+            start = 0;   /* full-height block */
+            end = 7;
+            break;
+        default:  /* normal visibility */
+            start = (SP->orig_cursor >> 8) & 0xff;
+            end = SP->orig_cursor & 0xff;
+    }
+
+    /* if scrnmode is not set, some BIOSes hang */
+
+    regs.h.ah = 0x01;
+    regs.h.al = (unsigned char)pdc_scrnmode; 
+    regs.h.ch = (unsigned char)start;
+    regs.h.cl = (unsigned char)end;
+    PDCINT(0x10, regs);
+
+    return ret_vis;
+}
+
+void PDC_set_title(const char *title)
+{
+    PDC_LOG(("PDC_set_title() - called: <%s>\n", title));
+}
+
+int PDC_set_blink(bool blinkon)
+{
+    PDCREGS regs;
+
+    switch (pdc_adapter)
+    {
+    case _EGACOLOR:
+    case _EGAMONO:
+    case _VGACOLOR:
+    case _VGAMONO:
+        regs.W.ax = 0x1003;
+        regs.W.bx = blinkon;
+
+        PDCINT(0x10, regs);
+
+        if (pdc_color_started)
+            COLORS = blinkon ? 8 : 16;
+
+        break;
+    default:
+        COLORS = 8;
+    }
+
+    return (COLORS - (blinkon * 8) != 8) ? OK : ERR;
+}

data/vendor/PDCurses/dos/pdcutil.c

@@ -0,0 +1,212 @@
+/* Public Domain Curses */
+
+#include <limits.h>
+#include "pdcdos.h"
+
+void PDC_beep(void)
+{
+    PDCREGS regs;
+
+    PDC_LOG(("PDC_beep() - called\n"));
+
+    regs.W.ax = 0x0e07;       /* Write ^G in TTY fashion */
+    regs.W.bx = 0;
+    PDCINT(0x10, regs);
+}
+
+#if UINT_MAX >= 0xfffffffful
+# define irq0_ticks()	(getdosmemdword(0x46c))
+/* For 16-bit platforms, we expect that the program will need _two_ memory
+   read instructions to read the tick count.  Between the two instructions,
+   if we do not turn off interrupts, an IRQ 0 might intervene and update the
+   tick count with a carry over from the lower half to the upper half ---
+   and our read count will be bogus.  */
+#elif defined __TURBOC__
+static unsigned long irq0_ticks(void)
+{
+    unsigned long t;
+    disable();
+    t = getdosmemdword(0x46c);
+    enable();
+    return t;
+}
+#elif defined __WATCOMC__
+static unsigned long irq0_ticks(void)
+{
+    unsigned long t;
+    _disable();
+    t = getdosmemdword(0x46c);
+    _enable();
+    return t;
+}
+#else
+# define irq0_ticks()	(getdosmemdword(0x46c))  /* FIXME */
+#endif
+
+static void do_idle(void)
+{
+    PDCREGS regs;
+
+    regs.W.ax = 0x1680;
+    PDCINT(0x2f, regs);
+    PDCINT(0x28, regs);
+}
+
+#define MAX_TICK	0x1800b0ul	/* no. of IRQ 0 clock ticks per day;
+					   BIOS counter (0:0x46c) will go up
+					   to MAX_TICK - 1 before wrapping to
+					   0 at midnight */
+#define MS_PER_DAY	86400000ul	/* no. of milliseconds in a day */
+
+void PDC_napms(int ms)
+{
+    unsigned long goal, start, current;
+
+    PDC_LOG(("PDC_napms() - called: ms=%d\n", ms));
+
+#if INT_MAX > MS_PER_DAY / 2
+    /* If `int' is 32-bit, we might be asked to "nap" for more than one day,
+       in which case the system timer might wrap around at least twice, and
+       that will be tricky to handle as is.  Slice the "nap" into half-day
+       portions.  */
+    while (ms > MS_PER_DAY / 2)
+    {
+        PDC_napms (MS_PER_DAY / 2);
+        ms -= MS_PER_DAY / 2;
+    }
+#endif
+
+    if (ms < 0)
+        return;
+
+    /* Scale the millisecond count by MAX_TICK / MS_PER_DAY.  The scaling
+       done here is not very precise, but what is more important is
+       preventing integer overflow.
+
+       The approximation 67 / 3680 can be obtained by considering the
+       convergents (mathworld.wolfram.com/Convergent.html) of MAX_TICK /
+       MS_PER_DAY 's continued fraction representation.  */
+#if MS_PER_DAY / 2 <= ULONG_MAX / 67ul
+# define MS_TO_TICKS(x)	((x) * 67ul / 3680ul)
+#else
+# error "unpossible!"
+#endif
+    goal = MS_TO_TICKS(ms);
+
+    if (!goal)
+        goal++;
+
+    start = irq0_ticks();
+    goal += start;
+
+    if (goal >= MAX_TICK)
+    {
+        /* We expect to cross over midnight!  Wait for the clock tick count
+           to wrap around, then wait out the remaining ticks.  */
+        goal -= MAX_TICK;
+
+        while (irq0_ticks() == start)
+            do_idle();
+
+        while (irq0_ticks() > start)
+            do_idle();
+
+        start = 0;
+    }
+
+    while (goal > (current = irq0_ticks()))
+    {
+        if (current < start)
+        {
+            /* If the BIOS time somehow gets reset under us (ugh!), then
+               restart (what is left of) the nap with `current' as the new
+               starting time.  Remember to adjust the goal time
+               accordingly!  */
+            goal -= start - current;
+            start = current;
+        }
+
+        do_idle();
+    }
+}
+
+const char *PDC_sysname(void)
+{
+    return "DOS";
+}
+
+PDC_version_info PDC_version = { PDC_PORT_DOS,
+          PDC_VER_MAJOR, PDC_VER_MINOR, PDC_VER_CHANGE,
+          sizeof( chtype),
+               /* note that thus far,  'wide' and 'UTF8' versions exist */
+               /* only for SDL2, X11,  Win32,  and Win32a;  elsewhere, */
+               /* these will be FALSE */
+#ifdef PDC_WIDE
+          TRUE,
+#else
+          FALSE,
+#endif
+#ifdef PDC_FORCE_UTF8
+          TRUE,
+#else
+          FALSE,
+#endif
+          };
+
+#ifdef __DJGPP__
+
+unsigned char getdosmembyte(int offset)
+{
+    unsigned char b;
+
+    dosmemget(offset, sizeof(unsigned char), &b);
+    return b;
+}
+
+unsigned short getdosmemword(int offset)
+{
+    unsigned short w;
+
+    dosmemget(offset, sizeof(unsigned short), &w);
+    return w;
+}
+
+unsigned long getdosmemdword(int offset)
+{
+    unsigned long dw;
+
+    dosmemget(offset, sizeof(unsigned long), &dw);
+    return dw;
+}
+
+void setdosmembyte(int offset, unsigned char b)
+{
+    dosmemput(&b, sizeof(unsigned char), offset);
+}
+
+void setdosmemword(int offset, unsigned short w)
+{
+    dosmemput(&w, sizeof(unsigned short), offset);
+}
+
+#endif
+
+#if defined(__WATCOMC__) && defined(__386__)
+
+void PDC_dpmi_int(int vector, pdc_dpmi_regs *rmregs)
+{
+    union REGPACK regs = {0};
+
+    rmregs->w.ss = 0;
+    rmregs->w.sp = 0;
+    rmregs->w.flags = 0;
+
+    regs.w.ax = 0x300;
+    regs.h.bl = vector;
+    regs.x.edi = FP_OFF(rmregs);
+    regs.x.es = FP_SEG(rmregs);
+
+    intr(0x31, &regs);
+}
+
+#endif

data/vendor/PDCurses/libobjs.mif

@@ -0,0 +1,26 @@
+# Common elements for most of the DOS, OS/2 and Win32
+# makefiles (not Watcom or LCC)
+
+PDCURSES_CURSES_H   = $(PDCURSES_SRCDIR)/curses.h
+PDCURSES_CURSPRIV_H   = $(PDCURSES_SRCDIR)/curspriv.h
+PDCURSES_HEADERS   = $(PDCURSES_CURSES_H) $(PDCURSES_CURSPRIV_H)
+PANEL_HEADER      = $(PDCURSES_SRCDIR)/panel.h
+TERM_HEADER      = $(PDCURSES_SRCDIR)/term.h
+
+srcdir   = $(PDCURSES_SRCDIR)/pdcurses
+demodir   = $(PDCURSES_SRCDIR)/demos
+
+LIBOBJS = addch.$(O) addchstr.$(O) addstr.$(O) attr.$(O) beep.$(O) \
+bkgd.$(O) border.$(O) clear.$(O) color.$(O) delch.$(O) deleteln.$(O) \
+deprec.$(O) getch.$(O) getstr.$(O) getyx.$(O) inch.$(O) inchstr.$(O) \
+initscr.$(O) inopts.$(O) insch.$(O) insstr.$(O) instr.$(O) kernel.$(O) \
+keyname.$(O) mouse.$(O) move.$(O) outopts.$(O) overlay.$(O) pad.$(O) \
+panel.$(O) printw.$(O) refresh.$(O) scanw.$(O) scr_dump.$(O) scroll.$(O) \
+slk.$(O) termattr.$(O) terminfo.$(O) touch.$(O) util.$(O) window.$(O) \
+debug.$(O)
+
+PDCOBJS = pdcclip.$(O) pdcdisp.$(O) pdcgetsc.$(O) pdckbd.$(O) pdcscrn.$(O) \
+pdcsetsc.$(O) pdcutil.$(O)
+
+DEMOS = testcurs.exe ozdemo.exe xmas.exe tuidemo.exe firework.exe \
+newtest.exe ptest.exe rain.exe worm.exe

data/vendor/PDCurses/makedist.mif

@@ -0,0 +1,20 @@
+# Makefile include: build a binary archive with Info-ZIP
+# under DOS, OS/2 or Win32
+
+dist: $(PDCLIBS)
+	echo PDCurses $(VERDOT) for $(PLATFORM1) > file_id.diz
+	echo ------------------------------------------ >> file_id.diz
+	echo Public Domain Curses library for >> file_id.diz
+	echo $(PLATFORM2). >> file_id.diz
+	echo Source available in PDCURS$(VER).ZIP >> file_id.diz
+	echo Public Domain. >> file_id.diz
+	echo $(PDCURSES_SRCDIR)\README.md > flist
+	echo $(PDCURSES_SRCDIR)\HISTORY.md >> flist
+	echo $(PDCURSES_SRCDIR)\curses.h >> flist
+	echo $(PDCURSES_SRCDIR)\panel.h >> flist
+	echo $(PDCURSES_SRCDIR)\term.h >> flist
+	echo $(LIBCURSES) >> flist
+	echo file_id.diz >> flist
+	zip -9jX $(ARCNAME) -@ <flist
+	del flist
+	del file_id.diz

data/vendor/PDCurses/man/README.md

@@ -0,0 +1,21 @@
+PDCurses Documentation
+======================
+
+Some plain text documents to provide a basic overview of PDCurses and
+details for specific platforms, along with a program to combine them
+with the "man page" sections from the source code files, into
+"PDCurses.md".
+
+
+Building
+--------
+
+- Type "make". ("make clean" to remove the built files.) A Unix-like
+  environment is required for the Makefile. This is called automatically
+  when doing a top-level make of the X11 port.
+
+
+Distribution Status
+-------------------
+
+Public Domain, except for manext.c, which is GPL 2+.

data/vendor/PDCurses/man/intro.md

@@ -0,0 +1,361 @@
+PDCurses User's Guide
+=====================
+
+Curses Overview
+---------------
+
+The X/Open Curses Interface Definition describes a set of C-Language
+functions that provide screen-handling and updating, which are
+collectively known as the curses library.
+
+The curses library permits manipulation of data structures called
+windows which may be thought of as two-dimensional arrays of
+characters representing all or part of a terminal's screen.  The
+windows are manipulated using a procedural interface described
+elsewhere.  The curses package maintains a record of what characters
+are on the screen.  At the most basic level, manipulation is done with
+the routines move() and addch() which are used to "move" the curses
+around and add characters to the default window, stdscr, which
+represents the whole screen.
+
+An application may use these routines to add data to the window in any
+convenient order.  Once all data have been added, the routine
+refresh() is called.  The package then determines what changes have
+been made which affect the screen.  The screen contents are then
+changed to reflect those characters now in the window, using a
+sequence of operations optimized for the type of terminal in use.
+
+At a higher level routines combining the actions of move() and addch()
+are defined, as are routines to add whole strings and to perform
+format conversions in the manner of printf().
+
+Interfaces are also defined to erase the entire window and to specify
+the attributes of individual characters in the window.  Attributes
+such as inverse video, underline and blink can be used on a
+per-character basis.
+
+New windows can be created by allowing the application to build
+several images of the screen and display the appropriate one very
+quickly.  New windows are created using the routine newwin().  For
+each routine that manipulates the default window, stdscr, there is a
+corresponding routine prefixed with w to manipulate the contents of a
+specified window; for example, move() and wmove().  In fact, move(...)
+is functionally equivalent to wmove( stdscr, ...).  This is similar to
+the interface offered by printf(...) and fprintf(stdout, ...).
+
+Windows do not have to correspond to the entire screen.  It is
+possible to create smaller windows, and also to indicate that the
+window is only partially visible on the screen.  Furthermore, large
+windows or pads, which are bigger than the actual screen size, may be
+created. 
+
+Interfaces are also defined to allow input character manipulation and
+to disable and enable many input attributes: character echo, single
+character input with or without signal processing (cbreak or raw
+modes), carriage returns mapping to newlines, screen scrolling, etc.
+
+
+Data Types and the \<curses.h\> Header
+--------------------------------------
+
+The data types supported by curses are described in this section.
+
+As the library supports a procedural interface to the data types, actual
+structure contents are not described.  All curses data are manipulated
+using the routines provided.
+
+
+### The \<curses.h\> Header
+
+The \<curses.h\> header defines various constants and declares the data
+types that are available to the application.
+
+
+### Data Types
+
+The following data types are declared:
+
+    WINDOW *  pointer to screen representation
+    SCREEN *  pointer to terminal descriptor
+    bool      boolean data type
+    chtype    representation of a character in a window
+    cchar_t   the wide-character equivalent of chtype
+    attr_t    for WA_-style attributes
+
+The actual WINDOW and SCREEN objects used to store information are
+created by the corresponding routines and a pointer to them is provided.
+All manipulation is through that pointer.
+
+
+### Variables
+
+The following variables are defined:
+
+    LINES         number of lines on terminal screen
+    COLS          number of columns on terminal screen
+    stdscr        pointer to the default screen window    
+    curscr        pointer to the current screen image
+    SP            pointer to the current SCREEN struct
+    Mouse_status  status of the mouse
+    COLORS        number of colors available
+    COLOR_PAIRS   number of color pairs available
+    TABSIZE       size of one TAB block
+    acs_map[]     alternate character set map  
+    ttytype[]     terminal name/description    
+
+
+### Constants
+
+The following constants are defined:
+
+#### General
+
+    FALSE         boolean false value
+    TRUE          boolean true value
+    NULL          zero pointer value
+    ERR           value returned on error condition
+    OK            value returned on successful completion
+
+#### Video Attributes
+
+Normally, attributes are a property of the character. 
+
+For chtype:
+
+    A_ALTCHARSET  use the alternate character set
+    A_BLINK       bright background or blinking
+    A_BOLD        bright foreground or bold
+    A_DIM         half bright -- no effect in PDCurses
+    A_INVIS       invisible
+    A_ITALIC      italic
+    A_LEFTLINE    line along the left edge
+    A_PROTECT     protected (?) -- PDCurses renders this as a 
+                  combination of the *LINE attributes
+    A_REVERSE     reverse video
+    A_RIGHTLINE   line along the right edge
+    A_STANDOUT    terminal's best highlighting mode
+    A_UNDERLINE   underline
+
+    A_ATTRIBUTES  bit-mask to extract attributes
+    A_CHARTEXT    bit-mask to extract a character
+    A_COLOR       bit-mask to extract a color-pair
+
+Not all attributes will work on all terminals. A_RIGHTLINE, A_LEFTLINE
+and A_ITALIC are specific to PDCurses. A_INVIS and A_ITALIC are given
+the same value in PDCurses.
+
+For attr_t:
+
+    WA_ALTCHARSET same as A_ALTCHARSET
+    WA_BLINK      same as A_BLINK
+    WA_BOLD       same as A_BOLD
+    WA_DIM        same as A_DIM
+    WA_INVIS      same as A_INVIS
+    WA_LEFT       same as A_LEFTLINE
+    WA_PROTECT    same as A_PROTECT
+    WA_REVERSE    same as A_REVERSE
+    WA_RIGHT      same as A_RIGHTLINE
+    WA_STANDOUT   same as A_STANDOUT
+    WA_UNDERLINE  same as A_UNDERLINE
+
+Note that while A_LEFTLINE and A_RIGHTLINE are PDCurses-specific,
+WA_LEFT and WA_RIGHT are standard. The following are also defined, for
+compatibility, but currently have no effect in PDCurses: WA_HORIZONTAL,
+WA_LOW, WA_TOP, WA_VERTICAL.
+
+### The Alternate Character Set
+
+For use in chtypes and with related functions. These are a portable way
+to represent graphics characters on different terminals.
+
+VT100-compatible symbols -- box characters:
+
+    ACS_ULCORNER  upper left box corner
+    ACS_LLCORNER  lower left box corner
+    ACS_URCORNER  upper right box corner
+    ACS_LRCORNER  lower right box corner
+    ACS_RTEE      right "T"
+    ACS_LTEE      left "T"
+    ACS_BTEE      bottom "T"
+    ACS_TTEE      top "T"
+    ACS_HLINE     horizontal line
+    ACS_VLINE     vertical line
+    ACS_PLUS      plus sign, cross, or four-corner piece
+
+VT100-compatible symbols -- other:
+
+    ACS_S1        scan line 1
+    ACS_S9        scan line 9
+    ACS_DIAMOND   diamond
+    ACS_CKBOARD   checkerboard -- 50% grey
+    ACS_DEGREE    degree symbol
+    ACS_PLMINUS   plus/minus sign
+    ACS_BULLET    bullet
+
+Teletype 5410v1 symbols -- these are defined in SysV curses, but are not
+well-supported by most terminals. Stick to VT100 characters for optimum
+portability:
+
+    ACS_LARROW    left arrow
+    ACS_RARROW    right arrow
+    ACS_DARROW    down arrow
+    ACS_UARROW    up arrow
+    ACS_BOARD     checkerboard -- lighter (less dense) than 
+                  ACS_CKBOARD
+    ACS_LANTERN   lantern symbol
+    ACS_BLOCK     solid block
+
+That goes double for these -- undocumented SysV symbols. Don't use them:
+
+    ACS_S3        scan line 3
+    ACS_S7        scan line 7
+    ACS_LEQUAL    less than or equal
+    ACS_GEQUAL    greater than or equal
+    ACS_PI        pi
+    ACS_NEQUAL    not equal
+    ACS_STERLING  pounds sterling symbol
+
+Box character aliases:
+
+    ACS_BSSB      same as ACS_ULCORNER
+    ACS_SSBB      same as ACS_LLCORNER
+    ACS_BBSS      same as ACS_URCORNER
+    ACS_SBBS      same as ACS_LRCORNER
+    ACS_SBSS      same as ACS_RTEE
+    ACS_SSSB      same as ACS_LTEE
+    ACS_SSBS      same as ACS_BTEE
+    ACS_BSSS      same as ACS_TTEE
+    ACS_BSBS      same as ACS_HLINE
+    ACS_SBSB      same as ACS_VLINE
+    ACS_SSSS      same as ACS_PLUS
+
+For cchar_t and wide-character functions, WACS_ equivalents are also 
+defined.
+
+### Colors
+
+For use with init_pair(), color_set(), etc.:
+
+    COLOR_BLACK
+    COLOR_BLUE
+    COLOR_GREEN
+    COLOR_CYAN
+    COLOR_RED
+    COLOR_MAGENTA
+    COLOR_YELLOW
+    COLOR_WHITE
+
+Use these instead of numeric values. The definition of the colors 
+depends on the implementation of curses.
+
+
+### Input Values
+
+The following constants might be returned by getch() if keypad() has
+been enabled.  Note that not all of these may be supported on a
+particular terminal:
+
+    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        function keys; space for 64 keys is reserved
+    KEY_F(n)      (KEY_F0+(n))
+    KEY_DL        delete line
+    KEY_IL        insert line
+    KEY_DC        delete character
+    KEY_IC        insert character
+    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 1 line forwards
+    KEY_SR        scroll 1 line backwards (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 virtual keypad
+    KEY_A3        upper right of virtual keypad
+    KEY_B2        center of virtual keypad
+    KEY_C1        lower left of virtual keypad
+    KEY_C3        lower right of virtual keypad
+
+    KEY_BTAB      Back tab key
+    KEY_BEG       Beginning 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_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 Reference key
+    KEY_REFRESH   Refresh key
+    KEY_REPLACE   Replace key
+    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 input 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_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
+
+The virtual keypad is arranged like this:
+
+    A1     up     A3
+    left          B2   right
+    C1    down    C3
+
+This list is incomplete -- see curses.h for the full list, and use the
+testcurs demo to see what values are actually returned. The above are
+just the keys required by X/Open. In particular, PDCurses defines many
+CTL_ and ALT_ combinations; these are not portable.
+
+--------------------------------------------------------------------------