summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorNeil Jerram <neiljerram@googlemail.com>2010-04-25 18:53:40 +0100
committerNeil Jerram <neiljerram@googlemail.com>2010-04-25 18:58:14 +0100
commit79bd99b3e407d89bc91fea59b119a2680b72b543 (patch)
tree14199aa5d897e75cf19be56f6f1db8fef186f075 /doc
parentde3ba527c4cfbd6e168191a4fd305aedccac6e0c (diff)
downloadguile-79bd99b3e407d89bc91fea59b119a2680b72b543.tar.gz
Move description of manual organisation from Preface to Introduction
This material isn't "meta-" enough to be in the Preface, and it supports (by its structure) some of the points that the Introduction makes about Guile, so I think it belongs here. * doc/ref/intro.texi (Introduction): Add `Organisation of this Manual' menu item and material to here... * doc/ref/preface.texi (Preface): ...from here.
Diffstat (limited to 'doc')
-rw-r--r--doc/ref/intro.texi46
-rw-r--r--doc/ref/preface.texi42
2 files changed, 47 insertions, 41 deletions
diff --git a/doc/ref/intro.texi b/doc/ref/intro.texi
index f3a736e57..7eb2ad31d 100644
--- a/doc/ref/intro.texi
+++ b/doc/ref/intro.texi
@@ -48,6 +48,7 @@ conventions that we use in this manual.
* Interactive Programming::
* Supporting Multiple Languages::
* Obtaining and Installing Guile::
+* Organisation of this Manual::
* Typographical Conventions::
@end menu
@@ -226,6 +227,51 @@ we have included the report in the Guile distribution; see
Language Scheme}.
This will also be installed in your info directory.
+@node Organisation of this Manual
+@section Organisation of this Manual
+
+The rest of this manual is organised into the following chapters.
+
+@table @strong
+@item Chapter 1: Introduction
+This part provides an overview of what Guile is and how you can use
+it. A whirlwind tour shows how Guile can be used interactively and as
+a script interpreter, how to link Guile into your own applications,
+and how to write modules of interpreted and compiled code for use with
+Guile. Everything introduced here is documented again and in full by
+the later parts of the manual. This part also explains how to obtain
+and install new versions of Guile, and how to report bugs effectively.
+
+@item Chapter 2: Programming in Scheme
+This part provides an overview of programming in Scheme with Guile.
+It covers how to invoke the @code{guile} program from the command-line
+and how to write scripts in Scheme. It also gives an introduction
+into the basic ideas of Scheme itself and to the various extensions
+that Guile offers beyond standard Scheme.
+
+@item Chapter 3: Programming in C
+This part provides an overview of how to use Guile in a C program. It
+discusses the fundamental concepts that you need to understand to
+access the features of Guile, such as dynamic types and the garbage
+collector. It explains in a tutorial like manner how to define new
+data types and functions for the use by Scheme programs.
+
+@item Chapter 4: Guile API Reference
+This part of the manual documents the Guile @acronym{API} in
+functionality-based groups with the Scheme and C interfaces presented
+side by side.
+
+@item Chapter 5: Guile Modules
+Describes some important modules, distributed as part of the Guile
+distribution, that extend the functionality provided by the Guile
+Scheme core.
+
+@item Chapter 6: GOOPS
+Describes GOOPS, an object oriented extension to Guile that provides
+classes, multiple inheritance and generic functions.
+
+@end table
+
@node Typographical Conventions
@section Typographical Conventions
diff --git a/doc/ref/preface.texi b/doc/ref/preface.texi
index f2d59cc53..d0adf3650 100644
--- a/doc/ref/preface.texi
+++ b/doc/ref/preface.texi
@@ -9,47 +9,7 @@
This manual describes how to use Guile, GNU's Ubiquitous Intelligent
Language for Extensions. It relates particularly to Guile version
-@value{VERSION}. The manual is divided into the following chapters.
-
-@table @strong
-@item Chapter 1: Introduction
-This part provides an overview of what Guile is and how you can use
-it. A whirlwind tour shows how Guile can be used interactively and as
-a script interpreter, how to link Guile into your own applications,
-and how to write modules of interpreted and compiled code for use with
-Guile. Everything introduced here is documented again and in full by
-the later parts of the manual. This part also explains how to obtain
-and install new versions of Guile, and how to report bugs effectively.
-
-@item Chapter 2: Programming in Scheme
-This part provides an overview of programming in Scheme with Guile.
-It covers how to invoke the @code{guile} program from the command-line
-and how to write scripts in Scheme. It also gives an introduction
-into the basic ideas of Scheme itself and to the various extensions
-that Guile offers beyond standard Scheme.
-
-@item Chapter 3: Programming in C
-This part provides an overview of how to use Guile in a C program. It
-discusses the fundamental concepts that you need to understand to
-access the features of Guile, such as dynamic types and the garbage
-collector. It explains in a tutorial like manner how to define new
-data types and functions for the use by Scheme programs.
-
-@item Chapter 4: Guile API Reference
-This part of the manual documents the Guile @acronym{API} in
-functionality-based groups with the Scheme and C interfaces presented
-side by side.
-
-@item Chapter 5: Guile Modules
-Describes some important modules, distributed as part of the Guile
-distribution, that extend the functionality provided by the Guile
-Scheme core.
-
-@item Chapter 6: GOOPS
-Describes GOOPS, an object oriented extension to Guile that provides
-classes, multiple inheritance and generic functions.
-
-@end table
+@value{VERSION}.
@menu
* Contributors::