payloads/libpayload/curses/PDCurses-3.4/x11/README

   1 PDCurses for X11
   2 ================
   3
   4 This is a port of PDCurses for X11, aka XCurses.  It is designed to
   5 allow existing curses programs to be re-compiled with PDCurses,
   6 resulting in native X11 programs.
   7
   8
   9 Building
  10 --------
  11
  12 . Run "./configure" in the top-level directory.
  13
  14   To build the wide-character version of the library, specify
  15   "--enable-widec" as a parameter. To use X Input Methods, add
  16   "--enable-xim". I recommend these options, but I haven't yet made
  17   them the defaults, for the sake of backwards compatibility and due to
  18   their new and relatively untested status.
  19
  20   If your system is lacking in UTF-8 support, you can force the use of
  21   UTF-8 instead of the system locale via "--enable-force-utf8". This is
  22   generally more useful in Windows.
  23
  24   If configure can't find your X include files or X libraries, you can
  25   specify the paths with the arguments "--x-includes=inc_path" and/or
  26   "--x-libraries=lib_path".
  27
  28   By default, the library and demo programs are built with the optimizer
  29   switch -O2. You can turn this off, and turn on debugging (-g), by
  30   adding "--with-debug" to the configure command.
  31
  32 . Run "make". This should build libXCurses and all the demo programs.
  33
  34 . Optionally, run "make install". curses.h and panel.h will be renamed
  35   when installed (to xcurses.h and xpanel.h), to avoid conflicts with
  36   any existing curses installations. Unrenamed copies of curses.h and
  37   panel.h are installed in (by default) /usr/local/include/xcurses.
  38
  39   libXpanel is just a symlink to libXCurses. Both curses and panel
  40   functions are in the main library.
  41
  42
  43 Distribution Status
  44 -------------------
  45
  46 As of April 13, 2006, the files in this directory are released to the
  47 Public Domain, except for ScrollBox*, which are under essentially the
  48 MIT X License.
  49
  50
  51 To be Done
  52 ----------
  53
  54 - have newterm() create a new X window
  55
  56 - provide a command line parsing function to enable X command line
  57   arguments to be parsed and stripped from the arguments passed back
  58   to the calling procedure.
  59
  60
  61 Acknowledgements
  62 ----------------
  63
  64 X11 port was provided by Mark Hessling <mark@rexx.org>