You can edit this page using wiki syntax for markup.

Article contents:== Outdated egg! This is an egg for CHICKEN 3, the unsupported old release. You're almost certainly looking for [[/eggref/4/readline|the CHICKEN 4 version of this egg]], if it exists. If it does not exist, there may be equivalent functionality provided by another egg; have a look at the [[https://wiki.call-cc.org/chicken-projects/egg-index-4.html|egg index]]. Otherwise, please consider porting this egg to the current version of CHICKEN. [[tags: egg]] [[toc:]] == readline A binding for the GNU readline library. == Interface [procedure] (gnu-readline PROMPT) Reads a line using the GNU readline() function and returns a string. PROMPT should also be a string. [procedure] (gnu-readline-clear-history) Clears the history buffer. [procedure] (gnu-readline-read-history FILENAME) Reads the history buffer from the file FILENAME (or ~/.history if FILENAME is #f). Returns 0 on success. [procedure] (gnu-readline-write-history FILENAME) Writes the history buffer to the file FILENAME (or ~/.history if FILENAME is #f). Returns 0 on success. Do not use unless you want to clobber simultaneous sessions. [procedure] (gnu-readline-append-history FILENAME) Appends only the new entries to FILENAME. [procedure] (gnu-readline-new-lines) Returns the number of new entries (input lines from this session). [procedure] (gnu-readline-truncate-history FILENAME NUMLINES) Truncates the history file FILENAME (or ~/.history if FILENAME is #f) to NUMLINES lines. Returns 0 on success. [procedure] (gnu-history-install-file-manager FILENAME [NUMLINES]) If you also want to make the command history span sessions, add the following: {{(gnu-history-install-file-manager (string-append (or (getenv "HOME") ".") "/.csi.history"))}} By default this will save 1000 lines of history between sessions (it will prune the history file to 1000 lines at startup). For a different history size, pass the desired number of lines as the (optional) second argument to gnu-history-install-file-manager. If #f is passed in, no history-file-pruning will take place. [procedure] (make-gnu-readline-port [PROMPT] [PROMPT2]) Returns an input-port that uses the GNU readline facility. If PROMPT is not given, the value returned by (repl-prompt) is used for generating the current prompt (see the Chicken manual for more details about repl-prompt). PROMPT2 is used when there are still unclosed parenthesis; if not given, an appropriate default is generated. [procedure] (gnu-readline-set-bounce-ms TIME) Changes the time that the cursor spends bouncing on the matching parenthesis - the default 500ms. To turn bouncing off completely, set to zero. [procedure] (gnu-readline-parse-and-bind CONFIG) Passes string CONFIG straight to the readline library for parsing (see the readline manual page for details). This extension supports static linking. == Examples % csi -quiet #;1> (use readline) #;2> (current-input-port (make-gnu-readline-port)) #;3> To get csi to keep a history use the following (in your ~/.csirc file): (use readline regex) (current-input-port (make-gnu-readline-port)) (gnu-history-install-file-manager (string-append (or (getenv "HOME") ".") "/.csi.history")) To set readline to behave somewhat like vi: (gnu-readline-parse-and-bind "set editing-mode vi") == Installation problems This extension requires GNU readline. You will receive errors if you don't have the C header files for your readline installation or if you use some versions of the BSD readline alternative, libedit. === MacOS X In particular, Mac OS X versions prior to 10.5 Leopard ship with {{/usr/lib/libreadline.dylib}} linked to an older libedit, causing the following error when you install this egg: /usr/bin/ld: Undefined symbols: _history_truncate_file To fix this, install a copy of GNU readline in {{/usr/local/lib}} or, if you're using MacPorts, symlink it: ln -s /opt/local/lib/libreadline.dylib /usr/local/lib Do ''not'' modify the readline link in {{/usr/lib}}. MacOS X 10.5.2 again causes errors when building this egg. Installing MacPorts and doing the symlink above fixes the problem. === Debian GNU/Linux and derivatives (such as Ubuntu) In the case of Debian, you should probably install the package {{libreadline-dev}}, which is not installed by default. == About this egg === Author Tony Garnock-Jones === Version history ; 1.97 : Fixed an old typo that could conceivably cause errors [elf] ; 1.96 : Fixed build process for real this time (ensuring tests for lib availability actually do set, etc.) [elf] ; 1.95 : Fixed build process [elf] ; 1.94 : Added backtraces to control-c breaks [elf] ; 1.93 : Fixed history so that multiple sessions dont clobber each other. [elf] ; 1.92 : Added proper signal handling [elf] ; 1.91 : Added support for static linking [felix] ; 1.9 : Ignores duplicate history entries [Thanks to Toby Butzon] ; 1.8 : Empty lines are not added to history [Thanks to Dan Muresan] ; 1.7 : Added parenthesis bouncing, a new auto-complete [Heath Johns] ; 1.6 : Export *completion-entry-function* to support autocomplete [Alejandro Forero Cuervo] ; 1.5 : prompt argument to make-gnu-readline-port is optional [felix] ; 1.4 : Replaced use of (end-of-file) with #!eof ; 1.3 : Checks more possible libraries to link with at build time [Thanks to Peter Bex] ; 1.2 : Adapted to new setup scheme. ; 1.1 : More features, changed license to GPL, links with either libtermcap or libncurses. ; 1.0 : Initial release === License Copyright (c) 2002 Tony Garnock-Jones Copyright (c) 2006 Heath Johns (paren bouncing and auto-completion code) This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA Description of your changes:

I would like to authenticate

Spam control

What do you get when you add 7 to 0?