michael@0: The files in this directory provide simple line-editing and history michael@0: support for the standalone javascript engine, through the 'editline' michael@0: library. michael@0: michael@0: editline has only been enabled for those platforms on which it is michael@0: known to build; to try it on a different platform, define JS_EDITLINE michael@0: before building. Line editing (and js.c) is not a supported feature michael@0: of the javascript library, so your mileage my vary. michael@0: michael@0: The editline API is a compatible subset of the FSF readline API; if michael@0: you have readline installed and would like to link to that instead, michael@0: define JS_READLINE. Note that the readline library is distributed michael@0: under the GPL, so any resulting binaries are not legally michael@0: distributable. michael@0: michael@0: The editline files used here have been modified to work with the js michael@0: build system and to quiet some compiler warnings, and also to remove michael@0: filename-completion support. michael@0: michael@0: If anyone knows of a more recent version of these files, or a site on michael@0: which they are being maintained, please let me know! michael@0: michael@0: Mike McCabe, mccabe@netscape.com michael@0: michael@0: michael@0: The original README file distributed with the editline library follows. michael@0: michael@0: michael@0: michael@0: This is a line-editing library. It can be linked into almost any michael@0: program to provide command-line editing and recall. michael@0: michael@0: It is call-compatible with the FSF readline library, but it is a michael@0: fraction of the size (and offers fewer features). It does not use michael@0: standard I/O. It is distributed under a "C News-like" copyright. michael@0: michael@0: Configuration is done in the Makefile. Type "make testit" to get michael@0: a small slow shell for testing. michael@0: michael@0: An earlier version was distributed with Byron's rc. Principal michael@0: changes over that version include: michael@0: Faster. michael@0: Is eight-bit clean (thanks to brendan@cs.widener.edu) michael@0: Written in K&R C, but ANSI compliant (gcc all warnings) michael@0: Propagates EOF properly; rc trip test now passes michael@0: Doesn't need or use or provide memmove. michael@0: More robust michael@0: Calling sequence changed to be compatible with readline. michael@0: Test program, new manpage, better configuration michael@0: More system-independent; includes Unix and OS-9 support. michael@0: michael@0: This contains some changes since the posting to comp.sources.misc: michael@0: Bugfix for completion on absolute pathnames. michael@0: Better handling of M-n versus showing raw 8bit chars. michael@0: Better signal handling. michael@0: Now supports termios/termio/sgttyb ioctl's. michael@0: Add M-m command to toggle how 8bit data is displayed. michael@0: michael@0: There is one known bug: michael@0: History-searching redraws the line wrong if the text michael@0: retrieved is shorter then the prompt. michael@0: michael@0: Enjoy, michael@0: Rich $alz michael@0: michael@0: michael@0: Copyright 1992,1993 Simmule Turner and Rich Salz. All rights reserved. michael@0: michael@0: This software is not subject to any license of the American Telephone michael@0: and Telegraph Company or of the Regents of the University of California. michael@0: michael@0: Permission is granted to anyone to use this software for any purpose on michael@0: any computer system, and to alter it and redistribute it freely, subject michael@0: to the following restrictions: michael@0: 1. The authors are not responsible for the consequences of use of this michael@0: software, no matter how awful, even if they arise from flaws in it. michael@0: 2. The origin of this software must not be misrepresented, either by michael@0: explicit claim or by omission. Since few users ever read sources, michael@0: credits must appear in the documentation. michael@0: 3. Altered versions must be plainly marked as such, and must not be michael@0: misrepresented as being the original software. Since few users michael@0: ever read sources, credits must appear in the documentation. michael@0: 4. This notice may not be removed or altered.