guile/guile-core/doc ChangeLog Makefile.am guil...

[Martin Grabmueller]

CVSROOT:        /cvs
Module name:    guile
Changes by:     Martin Grabmueller <address@hidden>     01/06/29 14:43:17

Modified files:
        guile-core/doc : ChangeLog Makefile.am guile.texi 
                         repl-modules.texi scheme-modules.texi 
Added files:
        guile-core/doc : misc-modules.texi 

Log message:
        * misc-modules.texi: New file.
        (Pretty Printing): New chapter.
        (Formatted Output): New chapter.
        
        * Makefile.am (guile_TEXINFOS): Added misc-modules.texi.
        
        * guile.texi (Top): Added inclusion of misc-modules.texi.
        
        * scheme-modules.texi (Included Guile Modules): Added (srfi
        srfi-4) and (ice-9 rw) modules.
        (Module System Quirks): Removed note that `module-export!' must be
        called via gh_eval_str, now that we have scm_c_export.
        
        * repl-modules.texi (Loading Readline Support, Readline Options):
        New nodes.

CVSWeb URLs:
http://savannah.gnu.org/cgi-bin/viewcvs/guile/guile-core/doc/misc-modules.texi?cvsroot=OldCVS&rev=1.1
http://savannah.gnu.org/cgi-bin/viewcvs/guile/guile-core/doc/ChangeLog.diff?cvsroot=OldCVS&tr1=1.105&tr2=1.106&r1=text&r2=text
http://savannah.gnu.org/cgi-bin/viewcvs/guile/guile-core/doc/Makefile.am.diff?cvsroot=OldCVS&tr1=1.19&tr2=1.20&r1=text&r2=text
http://savannah.gnu.org/cgi-bin/viewcvs/guile/guile-core/doc/guile.texi.diff?cvsroot=OldCVS&tr1=1.11&tr2=1.12&r1=text&r2=text
http://savannah.gnu.org/cgi-bin/viewcvs/guile/guile-core/doc/repl-modules.texi.diff?cvsroot=OldCVS&tr1=1.2&tr2=1.3&r1=text&r2=text
http://savannah.gnu.org/cgi-bin/viewcvs/guile/guile-core/doc/scheme-modules.texi.diff?cvsroot=OldCVS&tr1=1.11&tr2=1.12&r1=text&r2=text

Patches:
Index: guile/guile-core/doc/ChangeLog
diff -u guile/guile-core/doc/ChangeLog:1.105 
guile/guile-core/doc/ChangeLog:1.106
--- guile/guile-core/doc/ChangeLog:1.105        Wed Jun 27 11:12:46 2001
+++ guile/guile-core/doc/ChangeLog      Fri Jun 29 14:43:17 2001
@@ -1,3 +1,21 @@
+2001-06-29  Martin Grabmueller  <address@hidden>
+
+       * misc-modules.texi: New file.
+       (Pretty Printing): New chapter.
+       (Formatted Output): New chapter.
+
+       * Makefile.am (guile_TEXINFOS): Added misc-modules.texi.
+
+       * guile.texi (Top): Added inclusion of misc-modules.texi.
+
+       * scheme-modules.texi (Included Guile Modules): Added (srfi
+       srfi-4) and (ice-9 rw) modules.
+       (Module System Quirks): Removed note that `module-export!' must be
+       called via gh_eval_str, now that we have scm_c_export.
+
+       * repl-modules.texi (Loading Readline Support, Readline Options):
+       New nodes.
+
 2001-06-27  Neil Jerram  <address@hidden>
 
        * posix.texi (Network Sockets and Communication): Grammar fix -
Index: guile/guile-core/doc/Makefile.am
diff -u guile/guile-core/doc/Makefile.am:1.19 
guile/guile-core/doc/Makefile.am:1.20
--- guile/guile-core/doc/Makefile.am:1.19       Mon Jun 25 08:07:37 2001
+++ guile/guile-core/doc/Makefile.am    Fri Jun 29 14:43:17 2001
@@ -35,7 +35,7 @@
        scheme-reading.texi scheme-indices.texi slib.texi posix.texi \
        expect.texi scsh.texi tcltk.texi scripts.texi gh.texi scm.texi \
        appendices.texi indices.texi script-getopt.texi data-rep.texi \
-       extend.texi repl-modules.texi srfi-modules.texi \
+       extend.texi repl-modules.texi srfi-modules.texi misc-modules.texi \
        AUTHORS
 
 guile_tut_TEXINFOS = guile-tut.texi AUTHORS
Index: guile/guile-core/doc/guile.texi
diff -u guile/guile-core/doc/guile.texi:1.11 
guile/guile-core/doc/guile.texi:1.12
--- guile/guile-core/doc/guile.texi:1.11        Wed Jun 20 15:08:19 2001
+++ guile/guile-core/doc/guile.texi     Fri Jun 29 14:43:17 2001
@@ -80,7 +80,7 @@
 @sp 10
 @comment The title is printed in a large font.
 @title Guile Reference Manual
address@hidden $Id: guile.texi,v 1.11 2001/06/20 22:08:19 ossau Exp $
address@hidden $Id: guile.texi,v 1.12 2001/06/29 21:43:17 mgrabmue Exp $
 @subtitle For use with Guile @value{VERSION}
 @include AUTHORS
 
@@ -171,6 +171,8 @@
 * SRFI Support::                Support for various SRFIs.
 * Readline Support::            Module for using the readline library.
 * Value History::               Maintaining a value history in the REPL.
+* Pretty Printing::             Nicely formatting Scheme objects for output.
+* Formatted Output::            The @code{format} procedure.
 * Expect::                     Controlling interactive programs with Guile.
 * The Scheme shell (scsh)::
        The SCSH compatibility module has been made an
@@ -253,6 +255,7 @@
 @include posix.texi
 @include srfi-modules.texi
 @include repl-modules.texi
address@hidden misc-modules.texi
 @include expect.texi
 @include scsh.texi
 @c @include tcltk.texi
Index: guile/guile-core/doc/repl-modules.texi
diff -u guile/guile-core/doc/repl-modules.texi:1.2 
guile/guile-core/doc/repl-modules.texi:1.3
--- guile/guile-core/doc/repl-modules.texi:1.2  Wed May 16 11:08:12 2001
+++ guile/guile-core/doc/repl-modules.texi      Fri Jun 29 14:43:17 2001
@@ -13,6 +13,15 @@
 older command lines from the input history and even search through the
 history entries.
 
address@hidden
+* Loading Readline Support::    How to load readline support into Guile.
+* Readline Options::            How to modify readline's behaviour.
address@hidden menu
+
+
address@hidden Loading Readline Support
address@hidden Loading Readline Support
+
 The module is not loaded by default and so has to be loaded and
 activated explicitly.  This is done with two simple lines of code:
 
@@ -21,6 +30,8 @@
 (activate-readline)
 @end lisp
 
address@hidden FIXME::martin: Review me!
+
 The first line will load the necessary code, and the second will
 activate readline's features for the REPL.  If you plan to use this
 module often, you should save these to lines to your @file{.guile}
@@ -48,6 +59,40 @@
 expressions available.
 
 
address@hidden Readline Options
address@hidden Readline Options
+
address@hidden FIXME::martin: Review me!
+
address@hidden readline options
+The readline interface module can be configured in several ways to
+better suit the user's needs.  Configuration is done via the readline
+module's options interface, in a similar way to the evaluator and
+debugging options (@pxref{General option interface}.)
+
+Here is the list of readline options generated by typing
address@hidden(readline-options 'full)} in Guile.  You can also see the
+default values.
+
address@hidden
+bounce-parens   500   Time (ms) to show matching opening parenthesis (0 = off).
+history-length  200   History length.
+history-file    yes   Use history file.
address@hidden smalllisp
+
+The history length specifies how many input lines will be remembered.
+If the history contains that many lines and additional lines are
+entered, the oldest lines will be lost.  You can switch on/off the
+usage of the history file using the following call.
+
address@hidden
+(readline-disable 'history)
address@hidden lisp
+
+The readline options interface can only be used @emph{after} loading
+the readline module, because it is defined in that module.
+
+
 @page
 @node Value History
 @chapter Value History
@@ -79,3 +124,8 @@
 which is also caused by @code{(ice-9 history)}.  In the next line, this
 variable is used two times, to produce the value @code{$2}, which in
 turn is used in the calculation for @code{$3}.
+
+
address@hidden Local Variables:
address@hidden TeX-master: "guile.texi"
address@hidden End:
Index: guile/guile-core/doc/scheme-modules.texi
diff -u guile/guile-core/doc/scheme-modules.texi:1.11 
guile/guile-core/doc/scheme-modules.texi:1.12
--- guile/guile-core/doc/scheme-modules.texi:1.11       Mon Jun 18 12:08:31 2001
+++ guile/guile-core/doc/scheme-modules.texi    Fri Jun 29 14:43:17 2001
@@ -354,10 +354,6 @@
 which might be present in the scope of the expansion.
 
 @item
-From C, you need to construct a @code{module-export!} call using
address@hidden  This is cumbersome.
-
address@hidden
 When two or more used modules export bindings with the same names, the
 last accessed module wins, and the exported binding of that last module
 will silently be used.  This might lead to hard-to-find errors because
@@ -396,6 +392,9 @@
 @item (ice-9 rdelim)
 Line- and character-delimited input (@pxref{Line/Delimited}).
 
address@hidden (ice-9 rw)
+Block string input/output (@pxref{Block Reading and Writing}).
+
 @item (ice-9 documentation)
 Online documentation (REFFIXME).
 
@@ -406,6 +405,9 @@
 @item (srfi srfi-2)
 Support for @code{and-let*} (@pxref{SRFI-2}).
 
address@hidden (srfi srfi-4)
+Support for homogeneous numeric vectors (@pxref{SRFI-4}).
+
 @item (srfi srfi-6)
 Support for some additional string port procedures (@pxref{SRFI-6}).
 
@@ -614,9 +616,11 @@
 
 @node Compiled Code Modules
 @subsection Putting Compiled Code into Modules
+
address@hidden FIXME::martin: Change all gh_ references to their scm_ 
equivalents.
 
-The new primitives that you add to Guile with @code{gh_new_procedure} or
-with any of the other mechanisms are normally placed into the same
+The new primitives that you add to Guile with @code{gh_new_procedure}
+or with any of the other mechanisms are normally placed into the same
 module as all the other builtin procedures (like @code{display}).
 However, it is also possible to put new primitives into their own
 module.
@@ -695,6 +699,8 @@
 from Scheme to C and back.  Additionally, we need a function that will
 add them to the set of Guile primitives.  Because this is just an
 example, we will only implement this for the @code{j0} function, tho.
+
address@hidden FIXME::martin: Change all gh_ references to their scm_ 
equivalents.
 
 @smallexample
 #include <math.h>