curses 1.2.6 → 1.4.0

data/vendor/PDCurses/IMPLEMNT.md

@@ -0,0 +1,327 @@
+PDCurses Implementor's Guide
+============================
+
+- Version 1.3 - 20??/??/?? - notes about official ports, new indentation
+                             style; markdown
+- Version 1.2 - 2007/07/11 - added PDC_init_pair(), PDC_pair_content(),
+                             version history; removed pdc_atrtab
+- Version 1.1 - 2007/06/06 - minor cosmetic change
+- Version 1.0 - 2007/04/01 - initial revision
+
+This document is for those wishing to port PDCurses to a new platform,
+or just wanting to better understand how it works. Nothing here should
+be needed for application programming; for that, refer to PDCurses.md,
+as built in doc/, or distributed as a file separate from this source
+package. This document assumes that you've read the user-level
+documentation and are very familiar with application-level curses
+programming.
+
+If you want to submit your port for possible inclusion into the main
+PDCurses distribution, please follow these guidelines:
+
+ - Don't modify anything in the pdcurses directory or in other port
+   directories. Don't modify curses.h or curspriv.h unless absolutely
+   necessary. (And prefer modifying curspriv.h over curses.h.)
+
+ - Use the same indentation style, naming and scope conventions as the
+   existing code.
+
+ - Release all your code to the public domain -- no copyright. Code
+   under GPL, BSD, etc. will not be accepted.
+
+
+Data Structures
+===============
+
+A port of PDCurses must provide acs_map[], a 128-element array of
+chtypes, with values laid out based on the Alternate Character Set of
+the VT100 (see curses.h). PDC_transform_line() must use this table; when
+it encounters a chtype with the A_ALTCHARSET flag set, and an A_CHARTEXT
+value in the range 0-127, it must render it using the A_CHARTEXT portion
+of the corresponding value from this table, instead of the original
+value. Also, values may be read from this table by apps, and passed
+through functions such as waddch(), which does no special processing on
+control characters (0-31 and 127) when the A_ALTCHARSET flag is set.
+Thus, any control characters used in acs_map[] should also have the
+A_ALTCHARSET flag set. Implementations should provide suitable values
+for all the ACS_ macros defined in curses.h; other values in the table
+should be filled with their own indices (e.g., acs_map['E'] == 'E'). The
+table can be either hardwired, or filled by PDC_scr_open(). Existing
+ports define it in pdcdisp.c, but this is not required.
+
+
+Functions
+=========
+
+A port of PDCurses must implement the following functions, with extern
+scope. These functions are traditionally divided into several modules,
+as indicated below; this division is not required (only the functions
+are), but may make it easier to follow for someone familiar with the
+existing ports.
+
+Any other functions you create as part of your implementation should
+have static scope, if possible. If they can't be static, they should be
+named with the "PDC_" prefix. This minimizes the risk of collision with
+an application's choices.
+
+Current PDCurses style also uses a single leading underscore with the
+name of any static function; and modified BSD/Allman-style indentation,
+approximately equivalent to "indent -kr -nut -bl -bli0", with
+adjustments to keep every line under 80 columns.
+
+
+pdcdisp.c:
+----------
+
+### void PDC_gotoyx(int y, int x);
+
+Move the physical cursor (as opposed to the logical cursor affected by
+wmove()) to the given location. This is called mainly from doupdate().
+In general, this function need not compare the old location with the new
+one, and should just move the cursor unconditionally.
+
+### void PDC_transform_line(int lineno, int x, int len, const chtype *srcp);
+
+The core output routine. It takes len chtype entities from srcp (a
+pointer into curscr) and renders them to the physical screen at line
+lineno, column x. It must also translate characters 0-127 via acs_map[],
+if they're flagged with A_ALTCHARSET in the attribute portion of the
+chtype.
+
+
+pdcgetsc.c:
+-----------
+
+### int PDC_get_columns(void);
+
+Returns the size of the screen in columns. It's used in resize_term() to
+set the new value of COLS. (Some existing implementations also call it
+internally from PDC_scr_open(), but this is not required.)
+
+### int PDC_get_cursor_mode(void);
+
+Returns the size/shape of the cursor. The format of the result is
+unspecified, except that it must be returned as an int. This function is
+called from initscr(), and the result is stored in SP->orig_cursor,
+which is used by PDC_curs_set() to determine the size/shape of the
+cursor in normal visibility mode (curs_set(1)).
+
+### int PDC_get_rows(void);
+
+Returns the size of the screen in rows. It's used in resize_term() to
+set the new value of LINES. (Some existing implementations also call it
+internally from PDC_scr_open(), but this is not required.)
+
+
+pdckbd.c:
+---------
+
+### bool PDC_check_key(void);
+
+Keyboard/mouse event check, called from wgetch(). Returns TRUE if
+there's an event ready to process. This function must be non-blocking.
+
+### void PDC_flushinp(void);
+
+This is the core of flushinp(). It discards any pending key or mouse
+events, removing them from any internal queue and from the OS queue, if
+applicable.
+
+### int PDC_get_key(void);
+
+Get the next available key, or mouse event (indicated by a return of
+KEY_MOUSE), and remove it from the OS' input queue, if applicable. This
+function is called from wgetch(). This function may be blocking, and
+traditionally is; but it need not be. If a valid key or mouse event
+cannot be returned, for any reason, this function returns -1. Valid keys
+are those that fall within the appropriate character set, or are in the
+list of special keys found in curses.h (KEY_MIN through KEY_MAX). When
+returning a special key code, this routine must also set SP->key_code to
+TRUE; otherwise it must set it to FALSE. If SP->return_key_modifiers is
+TRUE, this function may return modifier keys (shift, control, alt),
+pressed alone, as special key codes; if SP->return_key_modifiers is
+FALSE, it must not. If modifier keys are returned, it should only happen
+if no other keys were pressed in the meantime; i.e., the return should
+happen on key up. But if this is not possible, it may return the
+modifier keys on key down (if and only if SP->return_key_modifiers is
+TRUE).
+
+### int PDC_modifiers_set(void);
+
+Called from PDC_return_key_modifiers(). If your platform needs to do
+anything in response to a change in SP->return_key_modifiers, do it
+here. Returns OK or ERR, which is passed on by the caller.
+
+### int PDC_mouse_set(void);
+
+Called by mouse_set(), mouse_on(), and mouse_off() -- all the functions
+that modify SP->_trap_mbe. If your platform needs to do anything in
+response to a change in SP->_trap_mbe (for example, turning the mouse
+cursor on or off), do it here. Returns OK or ERR, which is passed on by
+the caller.
+
+### void PDC_set_keyboard_binary(bool on);
+
+Set keyboard input to "binary" mode. If you need to do something to keep
+the OS from processing ^C, etc. on your platform, do it here. TRUE turns
+the mode on; FALSE reverts it. This function is called from raw() and
+noraw().
+
+
+pdcscrn.c:
+----------
+
+### bool PDC_can_change_color(void);
+
+Returns TRUE if init_color() and color_content() give meaningful
+results, FALSE otherwise. Called from can_change_color().
+
+### int PDC_color_content(short color, short *red, short *green, short *blue);
+
+The core of color_content(). This does all the work of that function,
+except checking for values out of range and null pointers.
+
+### int PDC_init_color(short color, short red, short green, short blue);
+
+The core of init_color(). This does all the work of that function,
+except checking for values out of range.
+
+### void PDC_init_pair(short pair, short fg, short bg);
+
+The core of init_pair(). This does all the work of that function, except
+checking for values out of range. The values passed to this function
+should be returned by a call to PDC_pair_content() with the same pair
+number. PDC_transform_line() should use the specified colors when
+rendering a chtype with the given pair number.
+
+### int PDC_pair_content(short pair, short *fg, short *bg);
+
+The core of pair_content(). This does all the work of that function,
+except checking for values out of range and null pointers.
+
+### void PDC_reset_prog_mode(void);
+
+The non-portable functionality of reset_prog_mode() is handled here --
+whatever's not done in _restore_mode(). In current ports: In OS/2, this
+sets the keyboard to binary mode; in Win32, it enables or disables the
+mouse pointer to match the saved mode; in others it does nothing.
+
+### void PDC_reset_shell_mode(void);
+
+The same thing, for reset_shell_mode(). In OS/2 and Win32, it restores
+the default console mode; in others it does nothing.
+
+### int PDC_resize_screen(int nlines, int ncols);
+
+This does the main work of resize_term(). It may respond to non-zero
+parameters, by setting the screen to the specified size; to zero
+parameters, by setting the screen to a size chosen by the user at
+runtime, in an unspecified way (e.g., by dragging the edges of the
+window); or both. It may also do nothing, if there's no appropriate
+action for the platform.
+
+### void PDC_restore_screen_mode(int i);
+
+Called from _restore_mode() in kernel.c, this function does the actual
+mode changing, if applicable. Currently used only in DOS and OS/2.
+
+### void PDC_save_screen_mode(int i);
+
+Called from _save_mode() in kernel.c, this function saves the actual
+screen mode, if applicable. Currently used only in DOS and OS/2.
+
+### void PDC_scr_close(void);
+
+The platform-specific part of endwin(). It may restore the image of the
+original screen saved by PDC_scr_open(), if the PDC_RESTORE_SCREEN
+environment variable is set; either way, if using an existing terminal,
+this function should restore it to the mode it had at startup, and move
+the cursor to the lower left corner. (The X11 port does nothing.)
+
+### void PDC_scr_free(void);
+
+Frees the memory for SP allocated by PDC_scr_open(). Called by
+delscreen().
+
+### int PDC_scr_open(int argc, char **argv);
+
+The platform-specific part of initscr(). It's actually called from
+Xinitscr(); the arguments, if present, correspond to those used with
+main(), and may be used to set the title of the terminal window, or for
+other, platform-specific purposes. (The arguments are currently used
+only in X11.) PDC_scr_open() must allocate memory for SP, and must
+initialize acs_map[] (unless it's preset) and several members of SP,
+including lines, cols, mouse_wait, orig_attr (and if orig_attr is TRUE,
+orig_fore and orig_back), mono, _restore and _preserve. (Although SP is
+used the same way in all ports, it's allocated here in order to allow
+the X11 port to map it to a block of shared memory.) If using an
+existing terminal, and the environment variable PDC_RESTORE_SCREEN is
+set, this function may also store the existing screen image for later
+restoration by PDC_scr_close().
+
+
+pdcsetsc.c:
+-----------
+
+### int PDC_curs_set(int visibility);
+
+Called from curs_set(). Changes the appearance of the cursor -- 0 turns
+it off, 1 is normal (the terminal's default, if applicable, as
+determined by SP->orig_cursor), and 2 is high visibility. The exact
+appearance of these modes is not specified.
+
+
+pdcutil.c:
+----------
+
+### void PDC_beep(void);
+
+Emits a short audible beep. If this is not possible on your platform,
+you must set SP->audible to FALSE during initialization (i.e., from
+PDC_scr_open() -- not here); otherwise, set it to TRUE. This function is
+called from beep().
+
+### void PDC_napms(int ms);
+
+This is the core delay routine, called by napms(). It pauses for about
+(the X/Open spec says "at least") ms milliseconds, then returns. High
+degrees of accuracy and precision are not expected (though desirable, if
+you can achieve them). More important is that this function gives back
+the process' time slice to the OS, so that PDCurses idles at low CPU
+usage.
+
+### const char *PDC_sysname(void);
+
+Returns a short string describing the platform, such as "DOS" or "X11".
+This is used by longname(). It must be no more than 100 characters; it
+should be much, much shorter (existing platforms use no more than 5).
+
+
+More functions
+==============
+
+The following functions are implemented in the platform directories, but
+are accessed directly by apps. Refer to the user documentation for their
+descriptions:
+
+
+pdcclip.c:
+----------
+
+### int PDC_clearclipboard(void);
+### int PDC_freeclipboard(char *contents);
+### int PDC_getclipboard(char **contents, long *length);
+### int PDC_setclipboard(const char *contents, long length);
+
+
+pdckbd.c:
+---------
+
+### unsigned long PDC_get_input_fd(void);
+
+
+pdcsetsc.c:
+-----------
+
+### int PDC_set_blink(bool blinkon);
+### void PDC_set_title(const char *title);

data/vendor/PDCurses/README.md

@@ -0,0 +1,77 @@
+Welcome to PDCurses!
+====================
+
+Public Domain Curses, aka PDCurses, is an implementation of X/Open
+curses for multiple platforms. Relative to the 'official' PDCurses
+project,  this has a variety of improvements,  adding a Windows GUI
+and a VT-like console "flavor" of Curses and expanding the
+capabilities of the other flavors (SDL1,  SDL2,  X11, Win32 console,
+OS/2, and DOS).  Some details and screen shots at
+
+https://www.projectpluto.com/win32a.htm
+
+Much of this was done during a long period in which 'official'
+PDCurses was inactive.  It is hoped that the changes in this fork
+can be merged into the 'official' PDCurses,  and a pull request has
+been made.  But the split is looking increasingly permanent.
+
+Legal Stuff
+-----------
+
+The core package is in the public domain, but small portions of PDCurses
+are subject to copyright under various licenses.  Each directory
+contains a README file, with a section titled "Distribution Status"
+which describes the status of the files in that directory.
+
+If you use PDCurses in an application, an acknowledgement would be
+appreciated, but is not mandatory. If you make corrections or
+enhancements to PDCurses, please forward them to the current maintainer
+for the benefit of other users.
+
+This software is provided AS IS with NO WARRANTY whatsoever.
+
+
+Ports
+-----
+
+PDCurses has been ported to DOS, OS/2, Win32, X11 and SDL1 and SDL2,
+and this version adds a Windows graphical and VT-like console
+flavor. A directory containing the port-specific source files exists
+for each of these platforms.
+
+Build instructions are in the README file for each platform:
+
+-  [DOS](dos/README.md) for use on DOS
+-  [OS/2](os2/README.md) for use on OS/2
+-  [SDL 1.x](sdl1/README.md) for use as separate SDL version 1 window
+-  [SDL 2.x](sdl2/README.md) for use as separate SDL version 2 window
+-  [wincon](wincon/README.md) (formerly win32) for use on Windows Console
+-  [WinGUI](wingui/README.md) for use on Windows Graphics Mode
+-  [X11](x11/README.md) (also called XCurses) for use as separate X11 window
+-  [VT](vt/README.md) for use on terminal
+
+Distribution Status
+-------------------
+
+All files in this directory except configure, config.guess and
+config.sub are released to the Public Domain. config.guess and
+config.sub are under the GPL; configure is under a free license
+described within it.
+
+Build Status
+-------------------
+
+PDCurses is automatically build in multiple environments:
+
+[![Build status Travis-CI](https://api.travis-ci.com/Bill-Gray/PDCurses.svg?branch=master)](https://travis-ci.com/Bill-Gray/PDCurses)
+, also providing artifacts: [![Build status Appveyor](https://ci.appveyor.com/api/projects/status/github/Bill-Gray/PDCurses?branch=master&svg=true)](https://ci.appveyor.com/project/Bill-Gray/PDCurses)
+
+
+Maintainer
+----------
+
+William McBrine <wmcbrine@gmail.com>  ("official" PDCurses)
+
+Bill Gray
+p&#x202e;&ocirc;&#xe7;.&ouml;tulp&#x165;c&eacute;j&ocirc;&#x159;p&#x40;ot&uacute;l&#x202c;m
+(this fork)

data/vendor/PDCurses/acs_defs.h

@@ -0,0 +1,265 @@
+/* Many of the following #defines are completely unused for the
+nonce.  For each character,  its code point in code page 437,
+Unicode,  and page 8859-1 are given.  The first is used for
+non-wide builds in Win32 console,  DOS,  SDL,  and OS/2.
+Unicode is used for all wide builds,  and for the non-wide
+build of WinGUI.  Code page 8859-1 is used for non-wide X11.
+
+   All of these characters exist in CP437 and Unicode.  Some
+don't exist in 8859-1,  in which case the last column is 'TBD'.
+Only 32 are used in ncurses.  So caution is advised. */
+
+#ifdef USE_ISO8859_CHARSET
+   #define CHOOSE( A, B, C)   (C)
+   #define TBD '!'
+#else
+   #define CHOOSE( A, B, C) (USE_UNICODE_ACS_CHARS ? B : A)
+#endif
+
+/* Codes found from https://en.wikipedia.org/wiki/Code_page_437 */
+
+#define SMILE                             CHOOSE( 0x01,  0x263a,  'O')
+#define REV_SMILE                         CHOOSE( 0x02,  0x263b,  'O')
+#define HEART                             CHOOSE( 0x03,  0x2665,  'H')
+#define DIAMOND                           CHOOSE( 0x04,  0x2666, 0x01)
+#define CLUB                              CHOOSE( 0x05,  0x2663,  'C')
+#define SPADE                             CHOOSE( 0x06,  0x2660,  'S')
+#define MEDIUM_BULLET                     CHOOSE( 0x07,  0x2022, 0xb7)
+#define REV_BULLET                        CHOOSE( 0x08,  0x2508, 0xb7)
+#define WHITE_BULLET                      CHOOSE( 0x09,  0x25cb,    7)
+#define REV_WHITE_BULLET                  CHOOSE( 0x0a,  0x25D9,    7)
+#define MALE_SYM                          CHOOSE( 0x0b,  0x2642,  'm')
+#define FEMALE_SYM                        CHOOSE( 0x0c,  0x2640,  'f')
+#define QTR_NOTE                          CHOOSE( 0x0d,  0x266a, 0xbc)
+#define EIGHTH_NOTE                       CHOOSE( 0x0e,  0x266b, 0xbd)
+#define SPLAT                             CHOOSE( 0x0f,  0xa4  , 0xa4)
+#define RIGHT_TRIANGLE                    CHOOSE( 0x10,  0x25b6,  '>')
+#define LEFT_TRIANGLE                     CHOOSE( 0x11,  0x25c0,  '<')
+#define UP_DOWN_ARROW                     CHOOSE( 0x12,  0x2195, 0x19)
+#define DBL_BANG                          CHOOSE( 0x13,  0x203c,  '!')
+#define PILCROW                           CHOOSE( 0x14,  0xb6  , 0xb6)
+#define SECTION_SIGN                      CHOOSE( 0x15,  0xa7  , 0xa7)
+#define LOW_QTR_BLOCK                     CHOOSE( 0x16,  0x25b2,  '_')
+#define UP_DOWN_ARROW_UNDERSCORED         CHOOSE( 0x17,  0x21ab, 0x19)
+#define UP_ARROW                          CHOOSE( 0x18,  0x2191,  '^')
+#define DOWN_ARROW                        CHOOSE( 0x19,  0x2193,  'v')
+#define RIGHT_ARROW                       CHOOSE( 0x1a,  0x2192,  '>')
+#define LEFT_ARROW                        CHOOSE( 0x1b,  0x2190,  '<')
+#define RIGHT_ANGLE                       CHOOSE( 0x1c,  0x221f,  0xe)
+#define LEFT_RIGHT_ARROW                  CHOOSE( 0x1d,  0x2194,  '-')
+#define UP_TRIANGLE                       CHOOSE( 0x1e,  0x25b2,  '^')
+#define DOWN_TRIANGLE                     CHOOSE( 0x1f,  0x25bc,  'v')
+
+#define UPPERCASE_C_CEDILLA               CHOOSE( 0x80,  0xc7  , 0xc7)
+#define LOWERCASE_U_UMLAUT                CHOOSE( 0x81,  0xfc  , 0xfc)
+#define LOWERCASE_E_ACUTE                 CHOOSE( 0x82,  0xe9  , 0xe9)
+#define LOWERCASE_A_CIRCUMFLEX            CHOOSE( 0x83,  0xe2  , 0xe2)
+#define LOWERCASE_A_UMLAUT                CHOOSE( 0x84,  0xe4  , 0xe4)
+#define LOWERCASE_A_GRAVE                 CHOOSE( 0x85,  0xe0  , 0xea)
+#define LOWERCASE_A_RING                  CHOOSE( 0x86,  0xe5  , 0xe5)
+#define LOWERCASE_C_CEDILLA               CHOOSE( 0x87,  0xe7  , 0xe7)
+#define LOWERCASE_E_CIRCUMFLEX            CHOOSE( 0x88,  0xea  , 0xea)
+#define LOWERCASE_E_UMLAUT                CHOOSE( 0x89,  0xeb  , 0xeb)
+#define LOWERCASE_E_GRAVE                 CHOOSE( 0x8a,  0xe8  , 0xe8)
+#define LOWERCASE_I_UMLAUT                CHOOSE( 0x8b,  0xef  , 0xef)
+#define LOWERCASE_I_CIRCUMFLEX            CHOOSE( 0x8c,  0xee  , 0xee)
+#define LOWERCASE_I_GRAVE                 CHOOSE( 0x8d,  0xec  , 0xce)
+#define UPPERCASE_A_UMLAUT                CHOOSE( 0x8e,  0xc4  , 0xc4)
+#define UPPERCASE_A_RING                  CHOOSE( 0x8f,  0xc5  , 0xc5)
+
+#define UPPERCASE_E_ACUTE                 CHOOSE( 0x90,  0xc9  , 0xc9)
+#define LOWERCASE_AE_LIGATURE             CHOOSE( 0x91,  0xe6  , 0xe6)
+#define UPPERCASE_AE_LIGATURE             CHOOSE( 0x92,  0xc6  , 0xc6)
+#define LOWERCASE_O_CIRCUMFLEX            CHOOSE( 0x93,  0xf4  , 0xf4)
+#define LOWERCASE_O_UMLAUT                CHOOSE( 0x94,  0xf6  , 0xf6)
+#define LOWERCASE_O_GRAVE                 CHOOSE( 0x95,  0xf2  , 0xf2)
+#define LOWERCASE_U_CIRCUMFLEX            CHOOSE( 0x96,  0xfb  , 0xfb)
+#define LOWERCASE_U_GRAVE                 CHOOSE( 0x97,  0xf9  , 0xf9)
+#define LOWERCASE_Y_UMLAUT                CHOOSE( 0x98,  0xff  , 0xff)
+#define UPPERCASE_O_UMLAUT                CHOOSE( 0x99,  0xd6  , 0xd6)
+#define UPPERCASE_U_UMLAUT                CHOOSE( 0x9a,  0xdc  , 0xdc)
+#define CENT_SIGN                         CHOOSE( 0x9b,  0xa2  , 0xa2)
+#define STERLING_SIGN                     CHOOSE( 0x9c,  0xa3  ,   30)
+#define YEN_SIGN                          CHOOSE( 0x9d,  0xa5  , 0xa5)
+#define PESETA_SIGN                       CHOOSE( 0x9e,  0x20a7,  TBD)
+#define F_WITH_HOOK                       CHOOSE( 0x9f,  0x0192,  TBD)
+
+#define LOWERCASE_A_ACUTE                 CHOOSE( 0xa0,  0xe1  , 0xe1)
+#define LOWERCASE_I_ACUTE                 CHOOSE( 0xa1,  0xed  , 0xed)
+#define LOWERCASE_O_ACUTE                 CHOOSE( 0xa2,  0xf3  , 0xf3)
+#define LOWERCASE_U_ACUTE                 CHOOSE( 0xa3,  0xfa  , 0xfa)
+#define LOWERCASE_N_TILDE                 CHOOSE( 0xa4,  0xf1  , 0xf1)
+#define UPPERCASE_N_TILDE                 CHOOSE( 0xa5,  0xd1  , 0xd1)
+#define A_ORDINAL                         CHOOSE( 0xa6,  0xaa  , 0xaa)
+#define O_ORDINAL                         CHOOSE( 0xa7,  0xba  , 0xba)
+#define INVERTED_QUESTION_MARK            CHOOSE( 0xa8,  0xbf  , 0xbf)
+#define REVERSED_NOT_SIGN                 CHOOSE( 0xa9,  0x2310,  TBD)
+#define NOT_SIGN                          CHOOSE( 0xaa,  0xac  , 0xac)
+#define VULGAR_HALF                       CHOOSE( 0xab,  0xbd  , 0xbd)
+#define VULGAR_QUARTER                    CHOOSE( 0xac,  0xbc  , 0xbc)
+#define INVERTED_EXCLAMATION_MARK         CHOOSE( 0xad,  0xa1  , 0xa1)
+#define LEFT_ANGLE_QUOTE_MARK             CHOOSE( 0xae,  0xab  , 0xab)
+#define RIGHT_ANGLE_QUOTE_MARK            CHOOSE( 0xaf,  0xbb  , 0xbb)
+
+#define LIGHT_SHADE                       CHOOSE( 0xb0,  0x2591, '#' )
+#define MEDIUM_SHADE                      CHOOSE( 0xb1,  0x2592,    2)
+#define DARK_SHADE                        CHOOSE( 0xb2,  0x2593,  TBD)
+#define BOX_VLINE                         CHOOSE( 0xb3,  0x2502,   25)
+#define BOX_RTEE                          CHOOSE( 0xb4,  0x2524,   22)
+#define BOX_SD_RTEE                       CHOOSE( 0xb5,  0x2561,   22)
+#define BOX_DS_RTEE                       CHOOSE( 0xb6,  0x2562,   22)
+#define BOX_DS_URCORNER                   CHOOSE( 0xb7,  0x2556,   12)
+#define BOX_SD_URCORNER                   CHOOSE( 0xb8,  0x2555,   12)
+#define BOX_D_RTEE                        CHOOSE( 0xb9,  0x2563,   22)
+#define BOX_D_VLINE                       CHOOSE( 0xba,  0x2551,   25)
+#define BOX_D_URCORNER                    CHOOSE( 0xbb,  0x2557,   12)
+#define BOX_D_LRCORNER                    CHOOSE( 0xbc,  0x255D,   11)
+#define BOX_DS_LRCORNER                   CHOOSE( 0xbd,  0x255c,   11)
+#define BOX_SD_LRCORNER                   CHOOSE( 0xbe,  0x255b,   11)
+#define BOX_URCORNER                      CHOOSE( 0xbf,  0x2510,   12)
+
+#define BOX_LLCORNER                      CHOOSE( 0xc0,  0x2514,   14)
+#define BOX_BTEE                          CHOOSE( 0xc1,  0x2534,   23)
+#define BOX_TTEE                          CHOOSE( 0xc2,  0x252c,   24)
+#define BOX_LTEE                          CHOOSE( 0xc3,  0x251c,   21)
+#define BOX_HLINE                         CHOOSE( 0xc4,  0x2500,   18)
+#define BOX_PLUS                          CHOOSE( 0xc5,  0x253c,   15)
+#define BOX_SD_LTEE                       CHOOSE( 0xc6,  0x255e,   21)
+#define BOX_DS_LTEE                       CHOOSE( 0xc7,  0x255f,   21)
+#define BOX_D_LLCORNER                    CHOOSE( 0xc8,  0x255A,   14)
+#define BOX_D_ULCORNER                    CHOOSE( 0xc9,  0x2554,   13)
+#define BOX_D_BTEE                        CHOOSE( 0xca,  0x2569,   23)
+#define BOX_D_TTEE                        CHOOSE( 0xcb,  0x2566,   24)
+#define BOX_D_LTEE                        CHOOSE( 0xcc,  0x2560,   21)
+#define BOX_D_HLINE                       CHOOSE( 0xcd,  0x2550,   18)
+#define BOX_D_PLUS                        CHOOSE( 0xce,  0x256C,   15)
+#define BOX_SD_BTEE                       CHOOSE( 0xcf,  0x2567,   23)
+
+#define BOX_DS_BTEE                       CHOOSE( 0xd0,  0x2568,   23)
+#define BOX_SD_TTEE                       CHOOSE( 0xd1,  0x2564,   24)
+#define BOX_DS_TTEE                       CHOOSE( 0xd2,  0x2565,   24)
+#define BOX_DS_LLCORNER                   CHOOSE( 0xd3,  0x2559,   14)
+#define BOX_SD_LLCORNER                   CHOOSE( 0xd4,  0x2558,   14)
+#define BOX_SD_ULCORNER                   CHOOSE( 0xd5,  0x2552,   13)
+#define BOX_DS_ULCORNER                   CHOOSE( 0xd6,  0x2553,   13)
+#define BOX_DS_PLUS                       CHOOSE( 0xd7,  0x256b,   15)
+#define BOX_SD_PLUS                       CHOOSE( 0xd8,  0x256a,   15)
+#define BOX_LRCORNER                      CHOOSE( 0xd9,  0x2518,   11)
+#define BOX_ULCORNER                      CHOOSE( 0xda,  0x250c,   13)
+#define FULL_BLOCK                        CHOOSE( 0xdb,  0x2588,    0)
+#define LOWER_HALF_BLOCK                  CHOOSE( 0xdc,  0x2584,  TBD)
+#define LEFT_HALF_BLOCK                   CHOOSE( 0xdd,  0x258c,  TBD)
+#define RIGHT_HALF_BLOCK                  CHOOSE( 0xde,  0x2590,  TBD)
+#define UPPER_HALF_BLOCK                  CHOOSE( 0xdf,  0x2580,  TBD)
+
+#define ALPHA                             CHOOSE( 0xe0,  0x03b1,  TBD)
+#define BETA                              CHOOSE( 0xe1,  0x00df,  TBD)
+#define GAMMA                             CHOOSE( 0xe2,  0x0393,  TBD)
+#define PI                                CHOOSE( 0xe3,  0x03c0,   28)
+#define UPPERCASE_SIGMA                   CHOOSE( 0xe4,  0x03a3,  TBD)
+#define LOWERCASE_SIGMA                   CHOOSE( 0xe5,  0x03c3,  TBD)
+#define MU                                CHOOSE( 0xe6,  0x00b5, 0xb5)
+#define TAU                               CHOOSE( 0xe7,  0x03c4,  TBD)
+#define UPPERCASE_PHI                     CHOOSE( 0xe8,  0x03a6,  TBD)
+#define THETA                             CHOOSE( 0xe9,  0x0398,  TBD)
+#define OMEGA                             CHOOSE( 0xea,  0x03a9,  TBD)
+#define DELTA                             CHOOSE( 0xeb,  0x03b4,  TBD)
+#define INFINITY_SIGN                     CHOOSE( 0xec,  0x221e,  TBD)
+#define LOWERCASE_PHI                     CHOOSE( 0xed,  0x03c6,  TBD)
+#define EPSILON                           CHOOSE( 0xee,  0x03b5,  TBD)
+#define INTERSECTION                      CHOOSE( 0xef,  0x2229,  TBD)
+
+#define TRIPLE_BAR                        CHOOSE( 0xf0,  0x2261,  TBD)
+#define PLUS_OR_MINUS                     CHOOSE( 0xf1,  0x00b1,    8)
+#define GREATER_THAN_OR_EQUAL_TO          CHOOSE( 0xf2,  0x2265,   27)
+#define LESSER_THAN_OR_EQUAL_TO           CHOOSE( 0xf3,  0x2264,   26)
+#define UPPER_HALF_INTEGRAL_SIGN          CHOOSE( 0xf4,  0x2320,  TBD)
+#define LOWER_HALF_INTEGRAL_SIGN          CHOOSE( 0xf5,  0x2321,  TBD)
+#define DIVISION_SIGN                     CHOOSE( 0xf6,  0x00f7, 0xf7)
+#define APPROXIMATELY_EQUALS_SIGN         CHOOSE( 0xf7,  0x2248,  TBD)
+#define DEGREE_SIGN                       CHOOSE( 0xf8,  0x00b0, 0xb0)
+#define LARGE_BULLET                      CHOOSE( 0xf9,  0x2219,    7)
+#define SMALL_BULLET                      CHOOSE( 0xfa,  0x00b7, 0xb7)
+#define SQUARE_ROOT                       CHOOSE( 0xfb,  0x221a,  TBD)
+#define SUPERSCRIPT_N                     CHOOSE( 0xfc,  0x207f,  TBD)
+#define SUPERSCRIPT_2                     CHOOSE( 0xfd,  0x00b2, 0xb2)
+#define CENTERED_SQUARE                   CHOOSE( 0xfe,  0x25a0,  TBD)
+#define NON_BREAKING_SPACE                CHOOSE( 0xff,  0x00a0,  TBD)
+
+
+
+      /* It says at http://unicode.org/charts/PDF/U2300.pdf */
+      /* that '...the scan line numbers here refer to old,  */
+      /* low-resolution technology for terminals, with only */
+      /* nine scan lines per fixed-size character glyph.    */
+      /* Even-numbered scan lines are unified with box      */
+      /* drawing graphics."                                 */
+      /*  The utility of these is questionable;  they'd     */
+      /* work Just Fine in wingdi (_if_ the appropriate     */
+      /* glyphs are available),  but not elsewhere.         */
+#define HORIZ_SCAN_LINE_1                 CHOOSE( 0x2d,  0x23ba,   16)
+#define HORIZ_SCAN_LINE_3                 CHOOSE( 0x2d,  0x23bb,   17)
+#define HORIZ_SCAN_LINE_7                 CHOOSE( 0x2d,  0x23bc,   19)
+#define HORIZ_SCAN_LINE_9                 CHOOSE(  '_',  0x23bd,   20)
+
+      /* Code page 437 lacks a 'for real' not-equals,  so for that, */
+      /* we use the double-horizontal single-vertical box drawing : */
+#define NOT_EQUALS_SIGN                   CHOOSE( 0xd8, 0x2260,    29)
+
+# define A(x) ((chtype)x | A_ALTCHARSET)
+
+chtype acs_map[128] =
+{
+   A(0), A(1), A(2), A(3), A(4), A(5), A(6), A(7), A(8),
+   A(9), A(10),
+   CLUB, HEART, SPADE, SMILE, REV_SMILE,                      /* 11 12 13 14 15 */
+   MEDIUM_BULLET, WHITE_BULLET, PILCROW, SECTION_SIGN,        /* 16 17 18 19 */
+   A_ORDINAL, O_ORDINAL, LOWERCASE_PHI,                       /* 20 21 22 */
+   INVERTED_EXCLAMATION_MARK, INVERTED_QUESTION_MARK,         /* 23 24 */
+   REVERSED_NOT_SIGN, NOT_SIGN,                               /* 25 26 */
+   UPPER_HALF_INTEGRAL_SIGN, LOWER_HALF_INTEGRAL_SIGN,        /* 27 28   */
+   SUPERSCRIPT_N, CENTERED_SQUARE, F_WITH_HOOK,               /* 29 30 31 */
+
+   RIGHT_ARROW, LEFT_ARROW, UP_ARROW, DOWN_ARROW,             /* 32 !"# */
+
+   PI, NOT_EQUALS_SIGN,  VULGAR_HALF, VULGAR_QUARTER,         /* $%&' */
+   '(',
+   LEFT_ANGLE_QUOTE_MARK, RIGHT_ANGLE_QUOTE_MARK,             /* )* */
+   DARK_SHADE, SUPERSCRIPT_2, INFINITY_SIGN,                  /* +,- */
+   ALPHA, BETA, GAMMA, UPPERCASE_SIGMA, LOWERCASE_SIGMA,      /* ./012  */
+   '3',
+   MU, TAU, UPPERCASE_PHI, THETA, OMEGA, DELTA, EPSILON,      /* 456789: */
+
+   BOX_SD_LRCORNER, BOX_SD_URCORNER, BOX_SD_ULCORNER,         /* ;<= */
+   BOX_SD_LLCORNER, BOX_SD_PLUS,                              /* >? */
+   BOX_SD_LTEE, BOX_SD_RTEE, BOX_SD_BTEE, BOX_SD_TTEE,        /* @ABC */
+
+   BOX_D_LRCORNER, BOX_D_URCORNER, BOX_D_ULCORNER,             /* DEF */
+   BOX_D_LLCORNER, BOX_D_PLUS,                                 /* GH */
+   BOX_D_LTEE, BOX_D_RTEE, BOX_D_BTEE, BOX_D_TTEE,             /* IJKL */
+
+   BOX_DS_LRCORNER, BOX_DS_URCORNER, BOX_DS_ULCORNER,          /* MNO */
+   BOX_DS_LLCORNER, BOX_DS_PLUS,                               /* PQ */
+   BOX_DS_LTEE, BOX_DS_RTEE, BOX_DS_BTEE, BOX_DS_TTEE,         /* RSTU */
+
+   BOX_LRCORNER, BOX_URCORNER, BOX_ULCORNER,                   /* VWX */
+   BOX_LLCORNER, BOX_PLUS,                                     /* YZ */
+   BOX_LTEE, BOX_RTEE, BOX_BTEE, BOX_TTEE,                     /* [\]^ */
+
+   BOX_HLINE, BOX_VLINE, BOX_D_HLINE, BOX_D_VLINE,             /* _`ab */
+
+   DIVISION_SIGN, APPROXIMATELY_EQUALS_SIGN,                   /* cd */
+   INTERSECTION, TRIPLE_BAR,                                   /* ef */
+   SMALL_BULLET, LARGE_BULLET, SQUARE_ROOT,                    /* ghi */
+   DIAMOND, MEDIUM_SHADE,                                      /* jk */
+   HORIZ_SCAN_LINE_1, HORIZ_SCAN_LINE_3,                       /* lm */
+   HORIZ_SCAN_LINE_7, HORIZ_SCAN_LINE_9,                       /* no */
+   UPPER_HALF_BLOCK, LOWER_HALF_BLOCK,                         /* pq */
+   LEFT_HALF_BLOCK, RIGHT_HALF_BLOCK, FULL_BLOCK,              /* rst */
+   LESSER_THAN_OR_EQUAL_TO, GREATER_THAN_OR_EQUAL_TO,          /* uv */
+   DEGREE_SIGN, PLUS_OR_MINUS, LIGHT_SHADE, SPLAT,             /* wxyz */
+   CENT_SIGN, YEN_SIGN, PESETA_SIGN, STERLING_SIGN,            /* {|}~ */
+    A(127)
+};
+
+# undef A