[Guile-commits] GNU Guile branch, master, updated. release_1-9-10-7-g4bd4b6e

[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=4bd4b6e67f7cdc3bd2e69e4e9692414972673335

The branch, master has been updated
       via  4bd4b6e67f7cdc3bd2e69e4e9692414972673335 (commit)
      from  b390b00834814f563a5dc13e2d629120f91990f6 (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 4bd4b6e67f7cdc3bd2e69e4e9692414972673335
Author: Andy Wingo <address@hidden>
Date:   Fri Apr 16 17:43:42 2010 +0200

    fold in feedback to api-languages
    
    * doc/ref/api-languages.texi: Fold in feedback.

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

Summary of changes:
 doc/ref/api-languages.texi |   30 +++++++++++++++++++++---------
 1 files changed, 21 insertions(+), 9 deletions(-)

diff --git a/doc/ref/api-languages.texi b/doc/ref/api-languages.texi
index a9531a2..3dcf985 100644
--- a/doc/ref/api-languages.texi
+++ b/doc/ref/api-languages.texi
@@ -13,9 +13,10 @@ number of other languages. Currently supported languages 
include Emacs
 Lisp and ECMAScript.
 
 Guile is still fundamentally a Scheme, but it tries to support a wide
-variety of language building-blocks, so that a user can implement other
-languages on top of Guile. This section describes the languages that
-have been implemented.
+variety of language building-blocks, so that other languages can be
+implemented on top of Guile. This allows users to write or extend
+applications in languages other than Scheme, too. This section describes
+the languages that have been implemented.
 
 (For details on how to implement a language, @xref{Compiling to the
 Virtual Machine}.)
@@ -31,7 +32,8 @@ Virtual Machine}.)
 @subsection Using Other Languages
 
 There are currently only two ways to access other languages from within
-Guile: at the REPL, and via @code{compile} or @code{compile-file}.
+Guile: at the REPL, and programmatically, via @code{compile},
address@hidden, and @code{compile-file}.
 
 The REPL is Guile's command prompt (@pxref{Using Guile Interactively}).
 The REPL has a concept of the ``current language'', which defaults to
@@ -132,7 +134,7 @@ version of @code{fold} written in Elisp can fold over a
 @code{'()}-terminated list, as made by Scheme.
 
 On a low level, the bit representations for @code{#f}, @code{#t},
address@hidden, and @code{'()} are made in such a way that the differ by
address@hidden, and @code{'()} are made in such a way that they differ by
 only one bit, and so a test for, for example, @address@hidden
 may be made very efficiently. See @code{libguile/boolean.h}, for more
 information.
@@ -240,17 +242,27 @@ Guile can warn when compiling code that has equality 
comparisons with
 @node Dynamic Binding
 @subsubsection Dynamic Binding
 
+In contrast to Scheme, which uses ``lexical scoping'', Emacs Lisp scopes
+its variables dynamically. Guile supports dynamic scoping with its
+``fluids'' facility. @xref{Fluids and Dynamic States}, for more
+information.
+
 @node Other Elisp Features
 @subsubsection Other Elisp Features
 
+Buffer-local and mode-local variables should be mentioned here, along
+with buckybits on characters, Emacs primitive data types, the
+Lisp-2-ness of Elisp, and other things. Contributions to the
+documentation are most welcome!
 
 @node ECMAScript
 @subsection ECMAScript
 
-ECMAScript was not the first non-Schemey language implemented by Guile,
-but it was the first implemented for Guile's bytecode compiler. The goal
-was to support ECMAScript version 3.1, a relatively small language, but
-the implementor was completely irresponsible and got distracted by other
address@hidden://www.ecma-international.org/publications/files/ECMA-ST/Ecma-262.pdf,ECMAScript}
+was not the first non-Schemey language implemented by Guile, but it was
+the first implemented for Guile's bytecode compiler. The goal was to
+support ECMAScript version 3.1, a relatively small language, but the
+implementor was completely irresponsible and got distracted by other
 things before finishing the standard library, and even some bits of the
 syntax. So, ECMAScript does deserve a mention in the manual, but it
 doesn't deserve an endorsement until its implementation is completed,


hooks/post-receive
-- 
GNU Guile