Assorted minor manual changes

[bpt/guile.git] / doc / ref / guile.texi

diff --git a/doc/ref/guile.texi b/doc/ref/guile.texi
index 66584fc..dc3dc07 100644 (file)
--- a/doc/ref/guile.texi
+++ b/doc/ref/guile.texi
@@ -167,7 +167,10 @@ x
 @menu
 
 * Preface::
-* Introduction to Guile::
+* Introduction::
+
+* Hello Guile!::
+* Hello Scheme!::
 
 * Programming in Scheme::
 * Programming in C::
@@ -203,38 +206,36 @@ Indices
 
 @include intro.texi
 
+@include tour.texi
+
+@raisesections
+@include scheme-ideas.texi
+@lowersections
+@include scheme-reading.texi
+
 @node Programming in Scheme
 @chapter Programming in Scheme
 
-Guile's core language is Scheme, and an awful lot can be achieved simply
-by using Guile to write and run Scheme programs.  In this part of the
-manual, we explain how to use Guile in this mode, and describe the tools
-that Guile provides to help you with script writing, debugging and
-packaging your programs for distribution.
-
-For readers who are not yet familiar with the Scheme language, this part
-includes a chapter that presents the basic concepts of the language, and
-gives references to freely available Scheme tutorial material on the
-web.
+Guile's core language is Scheme, and a lot can be achieved simply by using Guile
+to write and run Scheme programs --- as opposed to having to dive into C code.
+In this part of the manual, we explain how to use Guile in this mode, and
+describe the tools that Guile provides to help you with script writing,
+debugging and packaging your programs for distribution.
 
 For detailed reference information on the variables, functions
 etc. that make up Guile's application programming interface (API),
 @xref{API Reference}.
 
 @menu
-* Basic Ideas::                 Basic ideas in Scheme.
 * Guile Scheme::                Guile's implementation of Scheme.
 * Guile Scripting::             How to write Guile scripts.
 * Using Guile Interactively::   Guile's REPL features.
 * Using Guile in Emacs::        Guile and Emacs.
-* Further Reading::             Where to find out more about Scheme.
 @end menu
 
-@include scheme-ideas.texi
 @include scheme-intro.texi
 @include scheme-scripts.texi
 @include scheme-using.texi
-@include scheme-reading.texi
 
 @node Programming in C
 @chapter Programming in C
@@ -289,6 +290,7 @@ available through both Scheme and C interfaces.
 
 @menu
 * API Overview::                Overview of the Guile API.
+* Discouraged and Deprecated::  Obsolete back-compatible APIs.
 * The SCM Type::                The fundamental data type for C code.
 * Initialization::              Initializing Guile.
 * Snarfing Macros::             Macros for snarfing initialization actions.
@@ -315,6 +317,7 @@ available through both Scheme and C interfaces.
 @end menu
 
 @include api-overview.texi
+@include api-discdepr.texi
 @include api-scm.texi
 @include api-init.texi
 @include api-snarf.texi