[Guile-commits] GNU Guile branch, master, updated. release_1-9-10-54-gd93c0bc

[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=d93c0bc4c682a6d6b0eb1db59e6b4fcaa2389a36

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

    Bring the manual organisation section a little closer to reality
    
    FWIW I'm not sure I like this bullety presentation - but for now this
    just aligns the descriptions a bit closer to the actual chapters and
    chapter contents.
    
    * doc/ref/intro.texi (Organisation of this Manual): Cover `Hello
      Guile!' and `Hello Scheme!' chapters.  Thin out text for
      `Programming in Scheme'.  Renumber other chapters.

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

Summary of changes:
 doc/ref/intro.texi |   38 ++++++++++++++++++++------------------
 1 files changed, 20 insertions(+), 18 deletions(-)

diff --git a/doc/ref/intro.texi b/doc/ref/intro.texi
index d2faf35..94df98b 100644
--- a/doc/ref/intro.texi
+++ b/doc/ref/intro.texi
@@ -244,40 +244,42 @@ This will also be installed in your info directory.
 The rest of this manual is organised into the following chapters.
 
 @table @strong
address@hidden Chapter 1: Introduction
-This part provides an overview of what Guile is and how you can use
-it.  A whirlwind tour shows how Guile can be used interactively and as
address@hidden Chapter 2: Hello Guile!
+A whirlwind tour shows how Guile can be used interactively and as
 a script interpreter, how to link Guile into your own applications,
 and how to write modules of interpreted and compiled code for use with
 Guile.  Everything introduced here is documented again and in full by
-the later parts of the manual.  This part also explains how to obtain
-and install new versions of Guile, and how to report bugs effectively.
-
address@hidden Chapter 2: Programming in Scheme
-This part provides an overview of programming in Scheme with Guile.
-It covers how to invoke the @code{guile} program from the command-line
-and how to write scripts in Scheme.  It also gives an introduction
-into the basic ideas of Scheme itself and to the various extensions
-that Guile offers beyond standard Scheme.
-
address@hidden Chapter 3: Programming in C
-This part provides an overview of how to use Guile in a C program.  It
+the later parts of the manual.
+
address@hidden Chapter 3: Hello Scheme!
+For readers new to Scheme, this chapter provides an introduction to the basic
+ideas of the Scheme language.  This material would apply to any Scheme
+implementation and so does not make reference to anything Guile-specific.
+
address@hidden Chapter 4: Programming in Scheme
+Provides an overview of programming in Scheme with Guile.  It covers how to
+invoke the @code{guile} program from the command-line and how to write scripts
+in Scheme.  It also introduces the extensions that Guile offers beyond standard
+Scheme.
+
address@hidden Chapter 5: Programming in C
+Provides an overview of how to use Guile in a C program.  It
 discusses the fundamental concepts that you need to understand to
 access the features of Guile, such as dynamic types and the garbage
 collector.  It explains in a tutorial like manner how to define new
 data types and functions for the use by Scheme programs.
 
address@hidden Chapter 4: Guile API Reference
address@hidden Chapter 6: Guile API Reference
 This part of the manual documents the Guile @acronym{API} in
 functionality-based groups with the Scheme and C interfaces presented
 side by side.
 
address@hidden Chapter 5: Guile Modules
address@hidden Chapter 7: Guile Modules
 Describes some important modules, distributed as part of the Guile
 distribution, that extend the functionality provided by the Guile
 Scheme core.
 
address@hidden Chapter 6: GOOPS
address@hidden Chapter 8: GOOPS
 Describes GOOPS, an object oriented extension to Guile that provides
 classes, multiple inheritance and generic functions.
 


hooks/post-receive
-- 
GNU Guile