js/src/editline/README

Sat, 03 Jan 2015 20:18:00 +0100

author
Michael Schloh von Bennewitz <michael@schloh.com>
date
Sat, 03 Jan 2015 20:18:00 +0100
branch
TOR_BUG_3246
changeset 7
129ffea94266
permissions
-rw-r--r--

Conditionally enable double key logic according to:
private browsing mode or privacy.thirdparty.isolate preference and
implement in GetCookieStringCommon and FindCookie where it counts...
With some reservations of how to convince FindCookie users to test
condition and pass a nullptr when disabling double key logic.

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

mercurial