curses 1.3.2 → 1.4.3

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

data/vendor/PDCurses/man/manext.c

@@ -0,0 +1,119 @@
+/***********************************************************************/
+/* MANEXT - Extract manual pages from C source code.                   */
+/***********************************************************************/
+/*
+ * MANEXT - A program to extract manual pages from C source code.
+ * Copyright (C) 1991-1996 Mark Hessling
+ *
+ * This program is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU General Public License as
+ * published by the Free Software Foundation; either version 2 of
+ * the License, or any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+ * General Public License for more details.
+ *
+ * If you make modifications to this software that you feel increases
+ * it usefulness for the rest of the community, please email the
+ * changes, enhancements, bug fixes as well as any and all ideas to me.
+ * This software is going to be maintained and enhanced as deemed
+ * necessary by the community.
+ *
+ * Mark Hessling <mark@rexx.org>
+ */
+
+#include <stdio.h>
+#include <stdlib.h>
+#include <string.h>
+
+#define MAX_LINE 255
+
+void display_info()
+{
+    fprintf(stderr, "\nMANEXT 1.03 Copyright (C) 1991-1996 Mark Hessling\n"
+                    "All rights reserved.\n"
+                    "MANEXT is distributed under the terms of the GNU\n"
+                    "General Public License and comes with NO WARRANTY.\n"
+                    "See the file COPYING for details.\n"
+                    "\nUsage: manext sourcefile [...]\n\n");
+}
+
+int main(int argc, char **argv)
+{
+    char s[MAX_LINE + 1];       /* input line */
+    int i;
+    FILE *fp;
+
+#ifdef __EMX__
+    _wildcard(&argc, &argv);
+#endif
+    if (strcmp(argv[1], "-h") == 0)
+    {
+        display_info();
+        exit(1);
+    }
+
+    for (i = 1; i < argc; i++)
+    {
+        if ((fp = fopen(argv[i], "r")) == NULL)
+        {
+            fprintf(stderr, "\nCould not open %s\n", argv[i]);
+            continue;
+        }
+
+        while (!feof(fp))
+        {
+            if (fgets(s, (int)sizeof(s), fp) == NULL)
+            {
+                if (ferror(fp) != 0)
+                {
+                    fprintf(stderr, "*** Error reading %s.  Exiting.\n",
+                            argv[i]);
+                    exit(1);
+                }
+
+                break;
+            }
+
+            /* check for manual entry marker at beginning of line */
+
+            if (strncmp(s, "/*man-start*", 12) != 0)
+                continue;
+
+            /* inner loop */
+
+            for (;;)
+            {
+                /* read next line of manual entry */
+
+                if (fgets(s, (int)sizeof(s), fp) == NULL)
+                {
+                    if (ferror(fp) != 0)
+                    {
+                        fprintf(stderr, "*** Error reading %s.  Exiting.\n",
+                                argv[i]);
+                        exit(1);
+                    }
+
+                    break;
+                }
+
+                /* check for end of entry marker */
+
+                if (strncmp(s, "**man-end", 9) == 0)
+                    break;
+
+                printf("%s", s);
+            }
+
+            printf("\n\n-----------------------------------"
+                   "---------------------------------------\n\n");
+        }
+
+        fclose(fp);
+    }
+
+    return 0;
+}

data/vendor/PDCurses/man/sdl.md

@@ -0,0 +1,152 @@
+SDL Considerations
+==================
+
+There are no special requirements to use PDCurses for SDL -- all
+PDCurses-compatible code should work fine. (In fact, you can even build
+against the Win32 console pdcurses.dll, and then swap in the SDL
+pdcurses.dll.) Nothing extra is needed beyond the base SDL library.
+However, there are some optional special features, described here.
+
+The principal limitation of this port is that input is currently
+restricted to ASCII (i.e., 0-127), plus the special keys like KEY_LEFT.
+(You could have Unicode input, but then the input wouldn't match the
+output, which is in Code Page 437.) Also, see the note about the
+potential for incomplete output under "PDC_update_rects()", below.
+
+
+Fonts
+-----
+
+The font is a simple BMP, 32 characters wide by 8 characters tall,
+preferably with a palette. (BMPs without palettes still work, but in
+that case, no attributes will be available, nor will the cursor work.)
+The first entry in the palette (usually black) is treated as the
+background color; the last entry (usually white) is treated as the
+foreground. These are changed or made transparent as appropriate; any
+other colors in the palette are passed through unchanged. So -- although
+a one-bit depth is sufficient for a normal font -- you could redraw some
+characters as multi-colored tiles.
+
+The font must be monospaced. The size of each character is derived by
+dividing the width of the BMP by 32 and the height by 8. There is no
+constraint on the dimensions.
+
+As provided in the default font and expected by acs_map[], the font is
+in Code Page 437 form. But you can of course use any layout if you're
+not relying on correct values for the ACS_* macros.
+
+The font can be set via the environment variable PDC_FONT. If it's not
+set, PDCurses looks for a file named "pdcfont.bmp" in the current
+directory at the time of initscr(). If neither is found, it uses the
+built-in default font encoded in deffont.h.
+
+
+Backgrounds
+-----------
+
+PDCurses for SDL supports an optional background image BMP. This is used
+whenever start_color() has not been called (see the ptest demo for an
+example), or when use_default_colors() has been called after
+start_color(), and the background color of a pair has been set to -1
+(see ozdemo, worm, and rain for examples). The usage parallels that of
+ncurses in an appropriate terminal (e.g., Gnome Terminal). The image is
+tiled to cover the PDCurses window, and can be any size or depth.
+
+As with the font, you can point to a location for the background via the
+environment variable PDC_BACKGROUND; "pdcback.bmp" is the fallback.
+(There is no default background.)
+
+
+Icons
+-----
+
+The icon (used with SDL_WM_SetIcon() -- not used for the executable
+file) can be set via the environment variable PDC_ICON, and falls back
+to "pdcicon.bmp", and then to the built-in icon from deficon.h. The
+built-in icon is the PDCurses logo, as seen in ../x11/little_icon.xbm.
+The SDL docs say that the icon must be 32x32, at least for use with MS
+Windows.
+
+If pdc_screen is preinitialized (see below), PDCurses does not attempt
+to set the icon.
+
+
+Screen size
+-----------
+
+The default screen size is 80x25 characters (whatever size they may be),
+but you can override this via the environment variables PDC_COLS and/or
+PDC_LINES. (Some other ports use COLS and LINES; this is not done here
+because those values are, or should be, those of the controlling
+terminal, and PDCurses for SDL is independent of the terminal.) If
+pdc_screen is preinitialized (see below), these are ignored.
+
+
+Integration with SDL
+--------------------
+
+If you want to go further, you can mix PDCurses and SDL functions. (Of
+course this is extremely non-portable!) To aid you, there are several
+external variables and functions specific to the SDL port; you could
+include pdcsdl.h, or just add the declarations you need in your code:
+
+    PDCEX SDL_Surface *pdc_screen, *pdc_font, *pdc_icon, *pdc_back;
+    PDCEX int pdc_sheight, pdc_swidth, pdc_yoffset, pdc_xoffset;
+
+    void PDC_update_rects(void);
+    void PDC_retile(void);
+
+pdc_screen is the main surface, created by SDL_SetVideoMode(), unless
+it's preset before initscr(). You can perform normal SDL operations on
+this surface, but PDCurses won't respect them when it updates. (For
+that, see PDC_retile().) As an alternative, you can preinitialize this
+surface before calling initscr(). In that case, you can use pdc_sheight,
+pdc_swidth, pdc_yoffset and/or pdc_xoffset (q.v.) to confine PDCurses to
+only a specific area of the surface, reserving the rest for other SDL
+operations. If you preinitialize pdc_screen, you'll have to close it
+yourself; PDCurses will ignore resize events, and won't try to set the
+icon. Also note that if you preinitialize pdc_screen, it need not be the
+display surface.
+
+pdc_font, pdc_icon, and pdc_back are the SDL_surfaces for the font,
+icon, and background, respectively. You can set any or all of them
+before initscr(), and thus override any of the other ways to set them.
+But note that pdc_icon will be ignored if pdc_screen is preset.
+
+pdc_sheight and pdc_swidth are the dimensions of the area of pdc_screen
+to be used by PDCurses. You can preset them before initscr(); if either
+is not set, it defaults to the full screen size minus the x or y offset,
+as appropriate.
+
+pdc_xoffset and pdc_yoffset are the x and y offset for the area of
+pdc_screen to be used by PDCurses. See the sdltest demo for an example.
+
+PDC_retile() makes a copy of pdc_screen, then tiles it with the
+background image, if any. The resulting surface is used as the
+background for transparent character cells. PDC_retile() is called from
+initscr() and resize_term(). However, you can also use it at other
+times, to take advantage of the way it copies pdc_screen: Draw some SDL
+stuff; call PDC_retile(); do some curses stuff -- it will use whatever
+was on pdc_screen as the background. Then you can erase the curses
+screen, do some more SDL stuff, and call PDC_retile() again to make a
+new background. (If you don't erase the curses screen, it will be
+incorporated into the background when you call PDC_retile().) But this
+only works if no background image is set.
+
+PDC_update_rects() is how the screen actually gets updated. For
+performance reasons, when drawing, PDCurses for SDL maintains a table of
+rectangles that need updating, and only updates (by calling this
+function) during getch(), napms(), or when the table gets full.
+Normally, this is sufficient; but if you're pausing in some way other
+than by using napms(), and you're not doing keyboard checks, you may get
+an incomplete update. If that happens, you can call PDC_update_rects()
+manually.
+
+
+Interaction with stdio
+----------------------
+
+As with X11, it's a bad idea to mix curses and stdio calls. (In fact,
+that's true for PDCurses on any platform; but especially these two,
+which don't run under terminals.) Depending on how SDL is built, stdout
+and stderr may be redirected to files.

data/vendor/PDCurses/man/sdl2.md

@@ -0,0 +1,58 @@
+SDL2 Considerations
+===================
+
+Most of the information in the [SDL Considerations](sdl.md) document is also 
+valid for the SDL2 platform.  This document describes the differences.
+
+
+Integration with SDL2
+---------------------
+
+As mentioned in the [SDL Considerations](sdl.md) document, the SDL port uses
+the following variables:
+
+    SDL_Surface *pdc_screen, *pdc_font, *pdc_icon, *pdc_back;
+    int pdc_sheight, pdc_swidth, pdc_yoffset, pdc_xoffset;
+
+The SDL2 port adds:
+
+    SDL_Window *pdc_window;
+
+These can be used or modified in your own code.  Like the `pdc_screen` variable
+used by the SDL port, you can initialize `pdc_window` in your own code.  See the
+sdltest demo for an example.  If it's not initialized, PDCurses will do it for
+you.  If PDCurses initializes `pdc_window`, it will clean up/deallocate these
+variables on exit.
+
+
+Fonts
+-----
+
+If the `PDC_WIDE` flag is set during compilation, SDL2_ttf is used to render
+fonts.  This allows for use of a full UCS-2 (16 bit Unicode) character set.
+
+Using SDL2_ttf adds:
+
+    TTF_Font *pdc_ttffont;
+    int pdc_font_size;
+
+The default TrueType font can be modified by setting a define during compile
+time (e.g. `-DPDC_FONT_PATH=/usr/share/fonts/truetype/dejavu/`). This can be
+overridden by initializing `pdc_ttffont` in your own code.  Similar
+to the `PDC_FONT` environment variable for bitmap fonts, one can also override
+TTF fonts using the `PDC_FONT` environment variables.  Unless modified during
+compile time, the defaults are:
+
+    Windows: C:/Windows/Fonts/lucon.ttf
+    OS X:    /Library/Fonts/Courier New.ttf
+    Other:   /usr/share/fonts/truetype/freefont/FreeMono.ttf
+
+Font size can be set using the `PDC_FONT_SIZE` environment variable or by
+setting the value of `pdc_font_size` in your own code.  The default size is 18.
+
+
+Clipboard
+---------
+
+SDL2 port uses functionality provided by the SDL2 clipboard functions to add
+basic clipboard support.