ncurses/README

   1 -------------------------------------------------------------------------------
   2 -- Copyright (c) 1998-2006,2009 Free Software Foundation, Inc.               --
   3 --                                                                           --
   4 -- Permission is hereby granted, free of charge, to any person obtaining a   --
   5 -- copy of this software and associated documentation files (the             --
   6 -- "Software"), to deal in the Software without restriction, including       --
   7 -- without limitation the rights to use, copy, modify, merge, publish,       --
   8 -- distribute, distribute with modifications, sublicense, and/or sell copies --
   9 -- of the Software, and to permit persons to whom the Software is furnished  --
  10 -- to do so, subject to the following conditions:                            --
  11 --                                                                           --
  12 -- The above copyright notice and this permission notice shall be included   --
  13 -- in all copies or substantial portions of the Software.                    --
  14 --                                                                           --
  15 -- THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS   --
  16 -- OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF                --
  17 -- MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN --
  18 -- NO EVENT SHALL THE ABOVE COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,       --
  19 -- DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR     --
  20 -- OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE --
  21 -- USE OR OTHER DEALINGS IN THE SOFTWARE.                                    --
  22 --                                                                           --
  23 -- Except as contained in this notice, the name(s) of the above copyright    --
  24 -- holders shall not be used in advertising or otherwise to promote the      --
  25 -- sale, use or other dealings in this Software without prior written        --
  26 -- authorization.                                                            --
  27 -------------------------------------------------------------------------------
  28 -- $Id: README,v 1.10 2009/06/27 14:44:30 tom Exp $
  29 -------------------------------------------------------------------------------
  30 For discussion of the package internals, see hackguide.html in the doc/html
  31 directory.
  32
  33 -------------------------------------------------------------------------------
  34 The llib-lXXXX files could be used as lint-library sources (and were, at one
  35 time).  However, they are actually used as a documentation aid to keep track
  36 of changes to the public/private interfaces in ncurses.  Most of the text in
  37 these files is generated using cproto; some manual cleanup and adjustment of
  38 types (to reflect #define's in curses.h) is needed.  The functions listed in
  39 the llib-lXXXX files do not correspond to the default configure options; some
  40 additional ones are added to include "all" of the entrypoints for each of the
  41 major configurations (normal, wide-character, threaded):
  42
  43         --disable-macros
  44         --disable-root-environ
  45         --enable-expanded
  46         --enable-getcap
  47         --enable-getcap-cache
  48         --enable-sp-funcs
  49         --enable-termcap
  50         --with-develop