r4819: Auto commit for Debian build
[cl-readline.git] / README
diff --git a/README b/README
index 1dbf41db9e0e66b0d02d231026236ab000d61b05..d71dd79b04dd9f82a5899d89e6336890c7f2223a 100644 (file)
--- a/README
+++ b/README
@@ -1,4 +1,4 @@
-CL-READLINE 0.1
+CL-READLINE 0.1.1
 
  CL-READLINE is a simple UFFI-based wrapper for the GNU Readline
  library. 
@@ -7,8 +7,46 @@ CL-READLINE 0.1
  and CMUCL. Other platforms and UFFI compatible implementations should
  work, but may require tweaking.
 
- To use:
+  To load: 
 
-  (asdf:oos 'asdf:load-op 'readline)
-  (rl:readline :prompt "> ")
+       (asdf:oos 'asdf:load-op 'readline)
 
+  The interface exported by the package READLINE (nicknamed RL).
+
+Functions:
+
+  READLINE &key prompt history
+
+     prompt  -- a string (default "")
+     history -- a boolean (default t)
+
+     Prompt is the prompt displayed to user.
+
+     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.
+
+  ADD-HISTORY string
+
+     Adds the given string to history.
+
+  USE-FILENAME-COMPLETE
+
+     Use the Readline's default filename-completion system.
+
+  USE-CL-COMPLETE
+
+     Insert symbols in CL-USER to the custom completion pool,
+     and start using the custom completion system.
+
+  USE-CUSTOM-COMPLETE
+
+     Use the custom completion system.
+
+  ADD-COMPLETION
+
+     Add a completion to the custom completion pool.
+
+  CLEAR-COMPLETIONS
+
+     Empty the custom completion pool.