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

[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=3ce5e1304bd77eb167f856a2a163038f01f452c8

The branch, wip-manual-2 has been updated
       via  3ce5e1304bd77eb167f856a2a163038f01f452c8 (commit)
       via  c6c8e7e06d3a9b04ea5be2f0ac2a1029498e3a06 (commit)
      from  84d86e74531bbfd292696eb578910f6c7be51eda (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 3ce5e1304bd77eb167f856a2a163038f01f452c8
Author: Neil Jerram <address@hidden>
Date:   Mon Dec 21 01:09:43 2009 +0000

    Placeholders for expected remaining Intro sections
    
    * doc/ref/intro.texi (Introduction): Add menu entries and sections for
      `Guile and the GNU Project', `Interactive Programming' and
      `Supporting Multiple Languages'.

commit c6c8e7e06d3a9b04ea5be2f0ac2a1029498e3a06
Author: Neil Jerram <address@hidden>
Date:   Mon Dec 21 01:02:56 2009 +0000

    More intro text on combining with C code
    
    * doc/ref/intro.texi (Combining with C): New paragraph.

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

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

diff --git a/doc/ref/intro.texi b/doc/ref/intro.texi
index 78199a7..c91aacb 100644
--- a/doc/ref/intro.texi
+++ b/doc/ref/intro.texi
@@ -46,6 +46,9 @@ manual.
 @menu
 * Guile and Scheme::              
 * Combining with C::              
+* Guile and the GNU Project::
+* Interactive Programming::
+* Supporting Multiple Languages::
 * Obtaining and Installing Guile::  
 * Whirlwind Tour::              
 * Reporting Bugs::              
@@ -107,6 +110,18 @@ control structures, and even syntax to Guile, creating a 
domain-specific
 language tailored to the task at hand, but based on a robust language
 design.
 
+This kind of combination is helped by four aspects of Guile's design
+and history.  First is that Guile has always been targeted as an
+extension language.  Hence its C API has always been of great
+importance, and has been developed accordingly.  Second and third are
+rather technical points -- that Guile uses conservative garbage
+collection, and that it implements the Scheme concept of continuations
+by copying and reinstating the C stack -- but whose practical
+consequence is that most existing C code can be glued into Guile as
+is, without needing modifications to cope with strange Scheme
+execution flows.  Last is the module system, which helps extensions to
+coexist without stepping on each others' toes.
+
 Guile's module system allows one to break up a large program into
 manageable sections with well-defined interfaces between them.
 Modules may contain a mixture of interpreted and compiled code; Guile
@@ -116,6 +131,15 @@ routines for general distribution; as of this writing, one 
can find
 Emacs interfaces, database access routines, compilers, @acronym{GUI}
 toolkit interfaces, and @acronym{HTTP} client functions, among others.
 
address@hidden Guile and the GNU Project
address@hidden Guile and the GNU Project
+
address@hidden Interactive Programming
address@hidden Interactive Programming
+
address@hidden Supporting Multiple Languages
address@hidden Supporting Multiple Languages
+
 In the future, we hope to expand Guile to support other languages like
 Tcl and Perl by translating them to Scheme code.  This means that users
 can program applications which use Guile in the language of their


hooks/post-receive
-- 
GNU Guile