[Guile-commits] GNU Guile branch, master, updated. release_1-9-12-195-gf88dae8

[Andy Wingo]

This is an automated email from the git hooks/post-receive script. It was
generated because a ref change was pushed to the repository containing
the project "GNU Guile".

http://git.savannah.gnu.org/cgit/guile.git/commit/?id=f88dae81fe9dce0fd4af531899631ec070d10ea6

The branch, master has been updated
       via  f88dae81fe9dce0fd4af531899631ec070d10ea6 (commit)
       via  9322905ce786b7240fc6243214d80bc8f08cfe95 (commit)
      from  47bce022a88637966185f28a1d26e047e7871eac (commit)

Those revisions listed above that are new to this repository have
not appeared on any other notification email; so we list those
revisions in full, below.

- Log -----------------------------------------------------------------
commit f88dae81fe9dce0fd4af531899631ec070d10ea6
Author: Andy Wingo <address@hidden>
Date:   Mon Oct 11 23:53:40 2010 +0200

    add --listen docs
    
    * doc/ref/scheme-scripts.texi (Invoking Guile): Add --listen
      documentation.

commit 9322905ce786b7240fc6243214d80bc8f08cfe95
Author: Andy Wingo <address@hidden>
Date:   Mon Oct 11 23:32:30 2010 +0200

    preface contributors tweaks
    
    * doc/ref/preface.texi (Contributors): A couple tweaks

-----------------------------------------------------------------------

Summary of changes:
 doc/ref/preface.texi        |    6 +++---
 doc/ref/scheme-scripts.texi |   22 ++++++++++++++++++++++
 2 files changed, 25 insertions(+), 3 deletions(-)

diff --git a/doc/ref/preface.texi b/doc/ref/preface.texi
index 9e95685..97a5358 100644
--- a/doc/ref/preface.texi
+++ b/doc/ref/preface.texi
@@ -50,12 +50,12 @@ on reporting problems in this manual.
 
 The content for the first versions of this manual incorporated and was
 inspired by documents from Aubrey Jaffer, author of the SCM system on
-which Guile was based, and from Thomas Lord, Guile's first maintainer.
+which Guile was based, and from Tom Lord, Guile's first maintainer.
 Although most of this text has been rewritten, all of it was important,
 and some of the structure remains.
 
-The first versions of the first versions of Guile were written and
-edited largely by Mark Galassi and Jim Blandy.  In particular, Jim wrote
+The manual for the first versions of Guile were largely written, edited,
+and compiled by Mark Galassi and Jim Blandy.  In particular, Jim wrote
 the original tutorial on Guile's data representation and the C API for
 accessing Guile objects.
 
diff --git a/doc/ref/scheme-scripts.texi b/doc/ref/scheme-scripts.texi
index 8d47746..5a151a4 100644
--- a/doc/ref/scheme-scripts.texi
+++ b/doc/ref/scheme-scripts.texi
@@ -189,6 +189,28 @@ interactive session.  When executing a script with 
@code{-s} or
 Do not use the debugging VM engine, even when entering an interactive
 session.
 
address@hidden address@hidden
+While this program runs, listen on a local port or a path for REPL
+clients.  If @var{p} starts with a number, it is assumed to be a local
+port on which to listen.  If it starts with a forward slash, it is
+assumed to be a path to a UNIX domain socket on which to listen.
+
+If @var{p} is not given, the default is local port 37146.  If you look
+at it upside down, it almost spells ``Guile''.  If you have netcat
+installed, you should be able to @kbd{nc localhost 37146} and get a
+Guile prompt.  Alternately you can fire up Emacs and connect to the
+procedure; see @ref{Using Guile in Emacs} for more details.
+
+Note that opening a port allows anyone who can connect to that port---in
+the TCP case, any local user---to do anything Guile can do, as the user
+that the Guile process is running as.  Don't use @option{--listen} on
+multi-user machines.  Of course, if there is no @option{--listen}
+argument, no port will be opened.
+
+That said, @code{--listen} is great for interactive debugging and
+development.
+
address@hidden
 @item address@hidden, }--help
 Display help on invoking Guile, and then exit.
 


hooks/post-receive
-- 
GNU Guile