diff options
author | Neil Jerram <neiljerram@googlemail.com> | 2010-04-25 18:53:40 +0100 |
---|---|---|
committer | Neil Jerram <neiljerram@googlemail.com> | 2010-04-25 18:58:14 +0100 |
commit | 79bd99b3e407d89bc91fea59b119a2680b72b543 (patch) | |
tree | 14199aa5d897e75cf19be56f6f1db8fef186f075 /doc | |
parent | de3ba527c4cfbd6e168191a4fd305aedccac6e0c (diff) | |
download | guile-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.texi | 46 | ||||
-rw-r--r-- | doc/ref/preface.texi | 42 |
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:: |