[Guile-commits] GNU Guile branch, wip-manual-2, updated. release_1-9-6-18-gebb6158

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

The branch, wip-manual-2 has been updated
       via  ebb6158f2377c16285551e87d453cd5d93c90d46 (commit)
       via  95c2df5c60abbb5fcc217bde6efe47bff8e0ac3b (commit)
      from  3d9af0c96644022bfa0a6ca2a10c50e0c70c141c (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 ebb6158f2377c16285551e87d453cd5d93c90d46
Author: Neil Jerram <address@hidden>
Date:   Sat Dec 19 23:32:22 2009 +0000

    More about Guile's relationship to Scheme standards
    
    Also continue adding a bit more structure to the introductory "what is
    Guile" material.
    
    * doc/ref/intro.texi (Introduction): Split `What is Guile?' (which is
      a bad heading, since we've already answered that...) into `Guile and
      Scheme' and `Combining with C'.  Further splits will follow, to
      cover the other toplevel bullet points.
    
      (Guile and Scheme): Remove `packaged for use in a wide variety of
      environments', as I don't see what this can mean to the reader at
      this point.  Add text about R6RS and SRFIs.

commit 95c2df5c60abbb5fcc217bde6efe47bff8e0ac3b
Author: Neil Jerram <address@hidden>
Date:   Sat Dec 19 23:26:29 2009 +0000

    Format `Revised^n' more nicely in TeX
    
    * doc/ref/intro.texi (Introduction): Format Revised^n differently for
      TeX.

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

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

diff --git a/doc/ref/intro.texi b/doc/ref/intro.texi
index 4fabb48..50cf1f8 100644
--- a/doc/ref/intro.texi
+++ b/doc/ref/intro.texi
@@ -10,8 +10,14 @@
 Guile is an implementation of the Scheme programming language.  Scheme
 (@url{schemers.org}) is an elegant and conceptually simple dialect of
 Lisp, originated by Guy Steele and Gerald Sussman, and since evolved
-mainly by the series of reports known as RnRS (the Revised^n Reports
-on Scheme).
+by the series of reports known as RnRS (the
address@hidden
+Revised$^n$
address@hidden tex
address@hidden
+Revised^n
address@hidden ifnottex
+Reports onScheme).
 
 Unlike -- for example -- Python or Perl, Scheme has no benevolent
 dictator.  There are many Scheme implementations, with different
@@ -29,39 +35,61 @@ it emphasizes interactive and incremental programming
 it actually supports several languages, not just Scheme.
 @end itemize
 @noindent
-The next section explains what we mean by these points.  The sections
-after that cover how you can obtain and install Guile, a tour of the
-ways that you can use it, how to report any problems that you
+The next few sections explain what we mean by these points.  The
+sections after that cover how you can obtain and install Guile, a tour
+of the ways that you can use it, how to report any problems that you
 encounter, and some typographical conventions that we use in this
 manual.
 
 @menu
-* What is Guile?::              
+* Guile and Scheme::              
+* Combining with C::              
 * Obtaining and Installing Guile::  
 * Whirlwind Tour::              
 * Reporting Bugs::              
 * Typographical Conventions::          
 @end menu
 
address@hidden What is Guile?
address@hidden What is Guile?
address@hidden Guile and Scheme
address@hidden Guile and Scheme
 
-Guile is an interpreter for the Scheme programming language, packaged
-for use in a wide variety of environments.  Guile implements Scheme as
-described in the
+Guile implements Scheme as described in the
 @tex
 Revised$^5$
 @end tex
 @ifnottex
 Revised^5
 @end ifnottex
-Report on the Algorithmic Language Scheme (usually known as @acronym{R5RS}),
-providing clean and general data and control structures.  Guile goes
-beyond the rather austere language presented in @acronym{R5RS}, extending it 
with
-a module system, full access to @acronym{POSIX} system calls, networking 
support,
-multiple threads, dynamic linking, a foreign function call interface,
-powerful string processing, and many other features needed for
-programming in the real world.
+Report on the Algorithmic Language Scheme (usually known as
address@hidden), providing clean and general data and control
+structures.  Guile goes beyond the rather austere language presented
+in @acronym{R5RS}, extending it with a module system, full access to
address@hidden system calls, networking support, multiple threads,
+dynamic linking, a foreign function call interface, powerful string
+processing, and many other features needed for programming in the real
+world.
+
+The Scheme community has recently agreed and published R6RS, the
+latest installment in the RnRS series.  R6RS significantly expands the
+core Scheme language, and standardises many non-core functions that
+implementations -- including Guile -- have previously done in
+different ways.  Guile has been updated to incorporate some of the
+features of R6RS, and to adjust some existing features to conform to
+the R6RS specification, but it is by no means a complete R6RS
+implementation.
+
+Between R5RS and R6RS, the SRFI process
+(@url{http://srfi.schemers.org/}) standardised interfaces for many
+practical needs, such as multithreading programming and
+multidimensional arrays.  Guile supports many SRFIs, as documented in
+detail in @ref{SRFI Support}.
+
+In summary, so far as relationship to the Scheme standards is
+concerned, Guile is an R5RS implementation with many extensions, some
+of which conform to SRFIs or to the relevant parts of R6RS.
+
address@hidden Combining with C
address@hidden Combining with Other C Code
 
 Like a shell, Guile can run interactively, reading expressions from the
 user, evaluating them, and displaying the results, or as a script


hooks/post-receive
-- 
GNU Guile