1.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000
1.2 +++ b/js/src/editline/README Wed Dec 31 06:09:35 2014 +0100
1.3 @@ -0,0 +1,83 @@
1.4 +The files in this directory provide simple line-editing and history
1.5 +support for the standalone javascript engine, through the 'editline'
1.6 +library.
1.7 +
1.8 +editline has only been enabled for those platforms on which it is
1.9 +known to build; to try it on a different platform, define JS_EDITLINE
1.10 +before building. Line editing (and js.c) is not a supported feature
1.11 +of the javascript library, so your mileage my vary.
1.12 +
1.13 +The editline API is a compatible subset of the FSF readline API; if
1.14 +you have readline installed and would like to link to that instead,
1.15 +define JS_READLINE. Note that the readline library is distributed
1.16 +under the GPL, so any resulting binaries are not legally
1.17 +distributable.
1.18 +
1.19 +The editline files used here have been modified to work with the js
1.20 +build system and to quiet some compiler warnings, and also to remove
1.21 +filename-completion support.
1.22 +
1.23 +If anyone knows of a more recent version of these files, or a site on
1.24 +which they are being maintained, please let me know!
1.25 +
1.26 +Mike McCabe, mccabe@netscape.com
1.27 +
1.28 +
1.29 +The original README file distributed with the editline library follows.
1.30 +
1.31 +
1.32 +
1.33 +This is a line-editing library. It can be linked into almost any
1.34 +program to provide command-line editing and recall.
1.35 +
1.36 +It is call-compatible with the FSF readline library, but it is a
1.37 +fraction of the size (and offers fewer features). It does not use
1.38 +standard I/O. It is distributed under a "C News-like" copyright.
1.39 +
1.40 +Configuration is done in the Makefile. Type "make testit" to get
1.41 +a small slow shell for testing.
1.42 +
1.43 +An earlier version was distributed with Byron's rc. Principal
1.44 +changes over that version include:
1.45 + Faster.
1.46 + Is eight-bit clean (thanks to brendan@cs.widener.edu)
1.47 + Written in K&R C, but ANSI compliant (gcc all warnings)
1.48 + Propagates EOF properly; rc trip test now passes
1.49 + Doesn't need or use or provide memmove.
1.50 + More robust
1.51 + Calling sequence changed to be compatible with readline.
1.52 + Test program, new manpage, better configuration
1.53 + More system-independent; includes Unix and OS-9 support.
1.54 +
1.55 +This contains some changes since the posting to comp.sources.misc:
1.56 + Bugfix for completion on absolute pathnames.
1.57 + Better handling of M-n versus showing raw 8bit chars.
1.58 + Better signal handling.
1.59 + Now supports termios/termio/sgttyb ioctl's.
1.60 + Add M-m command to toggle how 8bit data is displayed.
1.61 +
1.62 +There is one known bug:
1.63 + History-searching redraws the line wrong if the text
1.64 + retrieved is shorter then the prompt.
1.65 +
1.66 +Enjoy,
1.67 + Rich $alz
1.68 + <rsalz@osf.org>
1.69 +
1.70 + Copyright 1992,1993 Simmule Turner and Rich Salz. All rights reserved.
1.71 +
1.72 + This software is not subject to any license of the American Telephone
1.73 + and Telegraph Company or of the Regents of the University of California.
1.74 +
1.75 + Permission is granted to anyone to use this software for any purpose on
1.76 + any computer system, and to alter it and redistribute it freely, subject
1.77 + to the following restrictions:
1.78 + 1. The authors are not responsible for the consequences of use of this
1.79 + software, no matter how awful, even if they arise from flaws in it.
1.80 + 2. The origin of this software must not be misrepresented, either by
1.81 + explicit claim or by omission. Since few users ever read sources,
1.82 + credits must appear in the documentation.
1.83 + 3. Altered versions must be plainly marked as such, and must not be
1.84 + misrepresented as being the original software. Since few users
1.85 + ever read sources, credits must appear in the documentation.
1.86 + 4. This notice may not be removed or altered.
