Index: Makefile.in
==================================================================
--- Makefile.in
+++ Makefile.in
@@ -1,9 +1,9 @@
 # -*- make -*-
 #
 # FILE: "/home/joze/src/tclreadline/Makefile.in"
-# LAST MODIFIED: "Sun Feb 28 18:09:19 1999 (joze)"
+# LAST MODIFIED: "Sun Feb 28 18:19:55 1999 (joze)"
 # (C) 1998, 1999 by Johannes Zellner
 # Johannes.Zellner@physik.uni-karlsruhe.de
 # $Id$
 # ---
 #
@@ -160,11 +160,12 @@
     tclreadline.c \
     tclreadline.h.in \
     tclreadlineConfig.sh.in \
     tclreadlineInit.tcl.in \
     tclreadlineSetup.tcl.in \
-    tclreadline.n.in
+    tclreadline.n.in \
+    sample.tclshrc
 
 AUXILIARY = \
     aux/config.guess \
     aux/config.sub \
     aux/install-sh \

Index: README
==================================================================
--- README
+++ README
@@ -1,42 +1,8 @@
-
-tclreadline
-
-$Id$
-
-1. Introduction
----------------
-
-This directory contains the sources and documentation for tclreadline,
-which builds a connection between tcl and the gnu readline.
-The information here corresponds to release 0.7 (initial developers release).
-
-2. Documentation
-----------------
-
-The "doc" subdirectory in this release contains the reference manual entries
-for tclreadline.  If you only want to use tclreadline as a tool for interactive
-script development,  you don't have to read this manual page at all.  Simply
-change your .tclshrc according to the next section.
-
-3. Compiling and installing tclreadline
--------------------------------
-
-This release will probably only build under UNIX (Linux).
-
-Before trying to compile tclreadline you should do the following things:
-
-    (a) Make sure you have tcl 8.0 or higher.  I've tested tclreadline
-        with tcl 8.0.3 and 8.0.4.  tclreadline relies on a proper tcl
-        installation:
-        It uses the tclConfig.sh file, which should reside somewhere
-        in /usr/local/lib/ or /usr/local/lib/tcl8.0/...
-
- /* ==================================================================
    
     FILE: "/home/joze/src/tclreadline/README"
-    LAST MODIFIED: "Sun Feb 28 15:04:28 1999 (joze)"
+    LAST MODIFIED: "Sun Feb 28 18:19:34 1999 (joze)"
     (C) 1998, 1999 by Johannes Zellner
     Johannes.Zellner@physik.uni-karlsruhe.de
     $Id$
     ---
 
@@ -58,6 +24,55 @@
     Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.
 
     Johannes.Zellner@physik.uni-karlsruhe.de
     http://krisal.physik.uni-karlsruhe.de/~joze
 
-    ================================================================== */  
+
+tclreadline
+
+
+1. Introduction
+---------------
+
+This directory contains the sources and documentation for tclreadline,
+which builds a connection between tcl and the gnu readline.
+The information here corresponds to release 0.7 (initial developers release).
+
+2. Documentation
+----------------
+
+The tclreadline.n nroff man page in this release contains the reference
+manual entries for tclreadline.  If you only want to use tclreadline as
+a tool for interactive script development,  you don't have to read this
+manual page at all.  Simply change your .tclshrc according to the section 4.
+
+3. Compiling and installing tclreadline
+---------------------------------------
+
+This release will probably only build under UNIX (Linux).
+
+Before trying to compile tclreadline you should do the following things:
+
+    (a) Make sure you have tcl 8.0 or higher.  I've tested tclreadline
+        with tcl 8.0.3 and 8.0.4.  tclreadline relies on a proper tcl
+        installation:
+        It uses the tclConfig.sh file, which should reside somewhere
+        in /usr/local/lib/ or /usr/local/lib/tcl8.0/...
+
+    (b) Make sure you have gnu readline 2.2 or higher.
+        tclreadline uses the gnu readline callback handler, which
+        wasn't implemented in early releases.
+
+The usual ./configure; make; make install sequence should do the rest.
+
+
+4. Using tclreadline for interactive tcl scripting.
+---------------------------------------------------
+
+copy the sample.tclshrc to $HOME/.tclshrc. If you use another interpreter
+like wish, you should copy the file sample.tclshrc to $HOME/.wishrc
+(or whatever the manual page of your interpreter says.) If you have
+installed tclreadline properly, you are just ready to start:
+start your favorite interpreter. The tclreadlineSetup.tcl script
+does the rest.
+
+