[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[Guile-commits] GNU Guile branch, wip-manual-2, updated. release_1-9-6-1
From: |
Neil Jerram |
Subject: |
[Guile-commits] GNU Guile branch, wip-manual-2, updated. release_1-9-6-18-gebb6158 |
Date: |
Sat, 19 Dec 2009 23:33:09 +0000 |
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
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- [Guile-commits] GNU Guile branch, wip-manual-2, updated. release_1-9-6-18-gebb6158,
Neil Jerram <=