update watch file

[cl-readline.git] / README

diff --git a/README b/README
index d71dd79b04dd9f82a5899d89e6336890c7f2223a..0c252bc7f4f49b2fe6a29850892857e73b32859f 100644 (file)
--- a/README
+++ b/README
@@ -1,4 +1,4 @@
-CL-READLINE 0.1.1
+CL-READLINE 0.3.0
 
  CL-READLINE is a simple UFFI-based wrapper for the GNU Readline
  library. 
@@ -7,13 +7,46 @@ CL-READLINE 0.1.1
  and CMUCL. Other platforms and UFFI compatible implementations should
  work, but may require tweaking.
 
-  To load: 
+ To load: 
 
        (asdf:oos 'asdf:load-op 'readline)
 
-  The interface exported by the package READLINE (nicknamed RL).
+ CL-READLINE behaviour can be modified via ~/.inputrc, see GNU
+ Readline documentation for details.
+
+
+API
+ 
+  (exported by "READLINE" package, nicknamed "RL")
+
+
+  ADD-COMPLETION
+
+     Add a completion to the custom completion pool.
+
+
+  ADD-HISTORY string
+
+     Adds the given string to history.
+
+
+  CLEAR-COMPLETIONS
+
+     Empty the custom completion pool.
+
+
+  READEXPR &key primary-prompt secondary-prompt history
+
+     primary-prompt   -- a string (default "=> ")
+     secondary-prompt -- a string (default "|      ")
+     history          -- a boolean (default t)
+
+     As READLINE, except reads enough lines to complete a lisp
+     expression.
+
+     Primary-prompt controls the prompt of the first line,
+     secondary prompt the prompt of the rest of the lines.
 
-Functions:
 
   READLINE &key prompt history
 
@@ -24,29 +57,31 @@ Functions:
 
      History controls whether the string read is added to history, or
      not. Note that history is available in any case. Currently there
-     is no way to erase history.
+     is no way to erase history. Leading and trailing whitespace is trimmed
+     from string before they are added to history, and strings that consist
+     entirely of whitespace are not saved to history.
 
-  ADD-HISTORY string
+     Dispite the cleanups performed on history, strings are returned as
+     read.
 
-     Adds the given string to history.
 
-  USE-FILENAME-COMPLETE
+  USE-CUSTOM-COMPLETE
 
-     Use the Readline's default filename-completion system.
+     Use the custom completion system. 
 
-  USE-CL-COMPLETE
 
-     Insert symbols in CL-USER to the custom completion pool,
-     and start using the custom completion system.
+  USE-FILENAME-COMPLETE
 
-  USE-CUSTOM-COMPLETE
+     Use the Readline's default filename-completion system.
 
-     Use the custom completion system.
 
-  ADD-COMPLETION
+  USE-PACKAGE-COMPLETE name
 
-     Add a completion to the custom completion pool.
+     Clear current custom completion pool, insert symbols in package
+     designated by NAME to the custom completion pool, and start using
+     the custom completion system.
 
-  CLEAR-COMPLETIONS
 
-     Empty the custom completion pool.
+  WITHOUT-ECHO form*
+
+     Runs forms without echoing of input on screen.