34 |
|
|
35 |
The manual is divided into five parts. |
The manual is divided into five parts. |
36 |
|
|
37 |
@strong{Part I: Introduction to Guile} provides an overview of what |
@table @strong |
38 |
Guile is and how you can use it. A whirlwind tour shows how Guile can |
@item Part I: Introduction to Guile |
39 |
be used interactively and as a script interpreter, how to link Guile |
Provides an overview of what Guile is and how you can use it. A |
40 |
into your own applications, and how to write modules of interpreted and |
whirlwind tour shows how Guile can be used interactively and as a |
41 |
compiled code for use with Guile. Everything introduced here is |
script interpreter, how to link Guile into your own applications, and |
42 |
documented again and in full by the later parts of the manual. This |
how to write modules of interpreted and compiled code for use with |
43 |
part also explains how to obtain and install new versions of Guile, and |
Guile. Everything introduced here is documented again and in full by |
44 |
how to report bugs effectively. |
the later parts of the manual. This part also explains how to obtain |
45 |
|
and install new versions of Guile, and how to report bugs effectively. |
46 |
@strong{Part II: Writing and Running Guile Scheme} and @strong{Part III: |
|
47 |
Programming with Guile} document all aspects of practical programming |
@item Part II: Writing and Running Guile Scheme |
48 |
using Guile. This covers both the Scheme level --- where we provide an |
@itemx Part III: Programming with Guile |
49 |
introduction to the key ideas of the Scheme language --- and use of |
Document all aspects of practical programming using Guile. This |
50 |
Guile's @code{scm} interface to write new primitives and objects in C, |
covers both the Scheme level --- where we provide an introduction to |
51 |
and to incorporate Guile into a C application. It also covers the use |
the key ideas of the Scheme language --- and use of Guile's @code{scm} |
52 |
of Guile as a POSIX-compliant script interpreter and how to use the |
interface to write new primitives and objects in C, and to incorporate |
53 |
Guile debugger. |
Guile into a C application. It also covers the use of Guile as a |
54 |
|
@acronym{POSIX}-compliant script interpreter and how to use the Guile |
55 |
|
debugger. |
56 |
|
|
57 |
@c @strong{Part V: Extending Applications Using Guile} explains the options |
@c @strong{Part V: Extending Applications Using Guile} explains the options |
58 |
@c available for using Guile as a application extension language. At the |
@c available for using Guile as a application extension language. At the |
67 |
@c This part of the manual covers the complete range of application |
@c This part of the manual covers the complete range of application |
68 |
@c extension options. |
@c extension options. |
69 |
|
|
70 |
@strong{Part IV: Guile API Reference} documents Guile's core API. Most |
@item Part IV: Guile API Reference |
71 |
of the variables and procedures in Guile's core programming interface |
Documents Guile's core @acronym{API}. Most of the variables and |
72 |
are available in both Scheme and C and are related systematically such |
procedures in Guile's core programming interface are available in both |
73 |
that the C interface can be inferred from the Scheme interface and vice |
Scheme and C and are related systematically such that the C interface |
74 |
versa. Therefore, this part of the manual documents the Guile API in |
can be inferred from the Scheme interface and vice versa. Therefore, |
75 |
|
this part of the manual documents the Guile @acronym{API} in |
76 |
functionality-based groups with the Scheme and C interfaces presented |
functionality-based groups with the Scheme and C interfaces presented |
77 |
side by side. Where the Scheme and C interfaces for a particular |
side by side. Where the Scheme and C interfaces for a particular |
78 |
functional area do differ --- which is sometimes inevitable, given the |
functional area do differ --- which is sometimes inevitable, given the |
89 |
@c all documented from scratch, and organized by functionality rather than |
@c all documented from scratch, and organized by functionality rather than |
90 |
@c by the defining standards. |
@c by the defining standards. |
91 |
|
|
92 |
@strong{Part V: Guile Modules} describes some important modules, |
@item Part V: Guile Modules |
93 |
distributed as part of the Guile distribution, that extend the |
Describes some important modules, distributed as part of the Guile |
94 |
functionality provided by the Guile Scheme core. Two important examples |
distribution, that extend the functionality provided by the Guile |
95 |
are: |
Scheme core. Two important examples are: |
96 |
|
|
97 |
@itemize @bullet |
@itemize @bullet |
98 |
@item |
@item |
99 |
the POSIX module, which provides Scheme-level procedures for system and |
The @acronym{POSIX} module, which provides Scheme-level procedures for |
100 |
network programming that conform to the POSIX standard |
system and network programming that conform to the @acronym{POSIX} |
101 |
|
standard. |
102 |
|
|
103 |
@item |
@item |
104 |
the SLIB module, which makes Aubrey Jaffer's portable Scheme library |
The @acronym{SLIB} module, which makes Aubrey Jaffer's portable Scheme |
105 |
available for use in Guile. |
library available for use in Guile. |
106 |
@end itemize |
@end itemize |
107 |
|
@end table |
108 |
|
|
109 |
|
|
110 |
@iftex |
@iftex |