[Guile-commits] GNU Guile branch, master, updated. release_1-9-10-53-g1d84577

[Neil Jerram]

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=1d84577c6a1cecf2b23c4901ef4e84cda9d17bd5

The branch, master has been updated
       via  1d84577c6a1cecf2b23c4901ef4e84cda9d17bd5 (commit)
      from  5bcaf46b75160f0325931c329020f3dc77e1adf8 (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 1d84577c6a1cecf2b23c4901ef4e84cda9d17bd5
Author: Neil Jerram <address@hidden>
Date:   Mon Apr 26 04:27:01 2010 +0100

    Assorted minor manual changes
    
    * doc/ref/guile.texi (Programming in Scheme): Remove "awful" and add
      "as opposed to having to dive into C code", to explain what we
      really mean here.  Remove incorrect para about the `Hello Scheme!'
      material.
    
    * doc/ref/intro.texi (Interactive Programming): Change "allows" to "is
      designed for" - sounds less accidental!
    
    * doc/ref/scheme-ideas.texi (Hello Scheme!): Remove unnecessary
      "reference", and inappropriate "randomness".

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

Summary of changes:
 doc/ref/guile.texi        |   15 +++++----------
 doc/ref/intro.texi        |   13 +++++++------
 doc/ref/scheme-ideas.texi |    9 +++++----
 3 files changed, 17 insertions(+), 20 deletions(-)

diff --git a/doc/ref/guile.texi b/doc/ref/guile.texi
index 278aca9..dc3dc07 100644
--- a/doc/ref/guile.texi
+++ b/doc/ref/guile.texi
@@ -216,16 +216,11 @@ Indices
 @node Programming in Scheme
 @chapter Programming in Scheme
 
-Guile's core language is Scheme, and an awful lot can be achieved simply
-by using Guile to write and run Scheme programs.  In this part of the
-manual, we explain how to use Guile in this mode, and describe the tools
-that Guile provides to help you with script writing, debugging and
-packaging your programs for distribution.
-
-For readers who are not yet familiar with the Scheme language, this part
-includes a chapter that presents the basic concepts of the language, and
-gives references to freely available Scheme tutorial material on the
-web.
+Guile's core language is Scheme, and a lot can be achieved simply by using 
Guile
+to write and run Scheme programs --- as opposed to having to dive into C code.
+In this part of the manual, we explain how to use Guile in this mode, and
+describe the tools that Guile provides to help you with script writing,
+debugging and packaging your programs for distribution.
 
 For detailed reference information on the variables, functions
 etc. that make up Guile's application programming interface (API),
diff --git a/doc/ref/intro.texi b/doc/ref/intro.texi
index 580e437..d2faf35 100644
--- a/doc/ref/intro.texi
+++ b/doc/ref/intro.texi
@@ -169,12 +169,13 @@ Then, for bonus points and maximising the ability for the 
user to experiment
 quickly with code changes, the system should allow parts of the source code to
 be modified and reloaded into the running program, to take immediate effect.
 
-Guile allows this kind of interactive programming, and this distinguishes it
-from many Scheme implementations that instead prioritise running a fixed Scheme
-program as fast as possible --- because there are tradeoffs between performance
-and the ability to modify parts of an already running program.  There are 
faster
-Schemes than Guile, but Guile is a GNU project and so prioritises the GNU 
vision
-of programming freedom and experimentation.
+Guile is designed for this kind of interactive programming, and this
+distinguishes it from many Scheme implementations that instead prioritise
+running a fixed Scheme program as fast as possible --- because there are
+tradeoffs between performance and the ability to modify parts of an already
+running program.  There are faster Schemes than Guile, but Guile is a GNU
+project and so prioritises the GNU vision of programming freedom and
+experimentation.
 
 @node Supporting Multiple Languages
 @section Supporting Multiple Languages
diff --git a/doc/ref/scheme-ideas.texi b/doc/ref/scheme-ideas.texi
index d2dfbe7..e111919 100644
--- a/doc/ref/scheme-ideas.texi
+++ b/doc/ref/scheme-ideas.texi
@@ -14,11 +14,12 @@ Readers who already possess a background knowledge of 
Scheme may happily
 skip this chapter.  For the reader who is new to the language, however,
 the following discussions on data, procedures, expressions and closure
 are designed to provide a minimum level of Scheme understanding that is
-more or less assumed by the reference chapters that follow.
+more or less assumed by the chapters that follow.
 
-The style of this introductory material aims about halfway between the
-terse precision of R5RS and the discursive randomness of a Scheme
-tutorial.
+The style of this introductory material aims about halfway between the terse
+precision of R5RS and the discursiveness of existing Scheme tutorials.  For
+pointers to useful Scheme resources on the web, please see @ref{Further
+Reading}.
 
 @menu
 * About Data::                  Latent typing, types, values and variables.


hooks/post-receive
-- 
GNU Guile