mirror/guile
mirror/guile
1
Fork 0
mirror of https://git.savannah.gnu.org/git/guile.git synced 2025-04-30 03:40:34 +02:00
Code Activity

Move description of manual organisation from Preface to Introduction

Browse source 
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:
Neil Jerram 2010-04-25 18:53:40 +01:00
parent de3ba527c4
commit 79bd99b3e4
2 changed files with 47 additions and 41 deletions
Download patch file Download diff file Expand all files Collapse all files

46
doc/ref/intro.texi
View file

@ -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

42
doc/ref/preface.texi
View file

@ -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::