mirror of
https://git.savannah.gnu.org/git/guile.git
synced 2025-05-01 04:10:18 +02:00
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.
This commit is contained in:
parent
de3ba527c4
commit
79bd99b3e4
2 changed files with 47 additions and 41 deletions
|
@ -48,6 +48,7 @@ conventions that we use in this manual.
|
||||||
* Interactive Programming::
|
* Interactive Programming::
|
||||||
* Supporting Multiple Languages::
|
* Supporting Multiple Languages::
|
||||||
* Obtaining and Installing Guile::
|
* Obtaining and Installing Guile::
|
||||||
|
* Organisation of this Manual::
|
||||||
* Typographical Conventions::
|
* Typographical Conventions::
|
||||||
@end menu
|
@end menu
|
||||||
|
|
||||||
|
@ -226,6 +227,51 @@ we have included the report in the Guile distribution; see
|
||||||
Language Scheme}.
|
Language Scheme}.
|
||||||
This will also be installed in your info directory.
|
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
|
@node Typographical Conventions
|
||||||
@section Typographical Conventions
|
@section Typographical Conventions
|
||||||
|
|
||||||
|
|
|
@ -9,47 +9,7 @@
|
||||||
|
|
||||||
This manual describes how to use Guile, GNU's Ubiquitous Intelligent
|
This manual describes how to use Guile, GNU's Ubiquitous Intelligent
|
||||||
Language for Extensions. It relates particularly to Guile version
|
Language for Extensions. It relates particularly to Guile version
|
||||||
@value{VERSION}. The manual is divided into the following chapters.
|
@value{VERSION}.
|
||||||
|
|
||||||
@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
|
|
||||||
|
|
||||||
@menu
|
@menu
|
||||||
* Contributors::
|
* Contributors::
|
||||||
|
|
Loading…
Add table
Add a link
Reference in a new issue