js/src/editline/README

   1 The files in this directory provide simple line-editing and history
   2 support for the standalone javascript engine, through the 'editline'
   3 library.
   4
   5 editline has only been enabled for those platforms on which it is
   6 known to build; to try it on a different platform, define JS_EDITLINE
   7 before building.  Line editing (and js.c) is not a supported feature
   8 of the javascript library, so your mileage my vary.
   9
  10 The editline API is a compatible subset of the FSF readline API; if
  11 you have readline installed and would like to link to that instead,
  12 define JS_READLINE.  Note that the readline library is distributed
  13 under the GPL, so any resulting binaries are not legally
  14 distributable.
  15
  16 The editline files used here have been modified to work with the js
  17 build system and to quiet some compiler warnings, and also to remove
  18 filename-completion support.
  19
  20 If anyone knows of a more recent version of these files, or a site on
  21 which they are being maintained, please let me know!
  22
  23 Mike McCabe, mccabe@netscape.com
  24
  25
  26 The original README file distributed with the editline library follows.
  27
  28
  29
  30 This is a line-editing library.  It can be linked into almost any
  31 program to provide command-line editing and recall.
  32
  33 It is call-compatible with the FSF readline library, but it is a
  34 fraction of the size (and offers fewer features).  It does not use
  35 standard I/O.  It is distributed under a "C News-like" copyright.
  36
  37 Configuration is done in the Makefile.  Type "make testit" to get
  38 a small slow shell for testing.
  39
  40 An earlier version was distributed with Byron's rc.  Principal
  41 changes over that version include:
  42         Faster.
  43         Is eight-bit clean (thanks to brendan@cs.widener.edu)
  44         Written in K&R C, but ANSI compliant (gcc all warnings)
  45         Propagates EOF properly; rc trip test now passes
  46         Doesn't need or use or provide memmove.
  47         More robust
  48         Calling sequence changed to be compatible with readline.
  49         Test program, new manpage, better configuration
  50         More system-independent; includes Unix and OS-9 support.
  51
  52 This contains some changes since the posting to comp.sources.misc:
  53         Bugfix for completion on absolute pathnames.
  54         Better handling of M-n versus showing raw 8bit chars.
  55         Better signal handling.
  56         Now supports termios/termio/sgttyb ioctl's.
  57         Add M-m command to toggle how 8bit data is displayed.
  58
  59 There is one known bug:
  60         History-searching redraws the line wrong if the text
  61         retrieved is shorter then the prompt.
  62
  63 Enjoy,
  64         Rich $alz
  65         <rsalz@osf.org>
  66
  67  Copyright 1992,1993 Simmule Turner and Rich Salz.  All rights reserved.
  68
  69  This software is not subject to any license of the American Telephone
  70  and Telegraph Company or of the Regents of the University of California.
  71
  72  Permission is granted to anyone to use this software for any purpose on
  73  any computer system, and to alter it and redistribute it freely, subject
  74  to the following restrictions:
  75  1. The authors are not responsible for the consequences of use of this
  76     software, no matter how awful, even if they arise from flaws in it.
  77  2. The origin of this software must not be misrepresented, either by
  78     explicit claim or by omission.  Since few users ever read sources,
  79     credits must appear in the documentation.
  80  3. Altered versions must be plainly marked as such, and must not be
  81     misrepresented as being the original software.  Since few users
  82     ever read sources, credits must appear in the documentation.
  83  4. This notice may not be removed or altered.