/js/lib/Socket.IO-node/support/expresso/deps/jscoverage/js/editline/README

 1The files in this directory provide simple line-editing and history
 2support for the standalone javascript engine, through the 'editline'
 3library.
 4
 5editline has only been enabled for those platforms on which it is
 6known to build; to try it on a different platform, define JS_EDITLINE
 7before building.  Line editing (and js.c) is not a supported feature
 8of the javascript library, so your mileage my vary.
 9
10The editline API is a compatible subset of the FSF readline API; if
11you have readline installed and would like to link to that instead,
12define JS_READLINE.  Note that the readline library is distributed
13under the GPL, so any resulting binaries are not legally
14distributable.
15
16The editline files used here have been modified to work with the js
17build system and to quiet some compiler warnings, and also to remove
18filename-completion support.
19
20If anyone knows of a more recent version of these files, or a site on
21which they are being maintained, please let me know!
22
23Mike McCabe, mccabe@netscape.com
24
25
26The original README file distributed with the editline library follows.
27
28
29
30This is a line-editing library.  It can be linked into almost any
31program to provide command-line editing and recall.
32
33It is call-compatible with the FSF readline library, but it is a
34fraction of the size (and offers fewer features).  It does not use
35standard I/O.  It is distributed under a "C News-like" copyright.
36
37Configuration is done in the Makefile.  Type "make testit" to get
38a small slow shell for testing.
39
40An earlier version was distributed with Byron's rc.  Principal
41changes 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-independant; includes Unix and OS-9 support.
51
52This 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
59There is one known bug:
60	History-searching redraws the line wrong if the text
61	retrieved is shorter then the prompt.
62
63Enjoy,
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.