7 |
@set MANUAL_EDITION 1.0 |
@set MANUAL_EDITION 1.0 |
8 |
@c %**end of header |
@c %**end of header |
9 |
|
|
10 |
@c Notes: (distilled from Jim's and Tim's notes, and kept up to date) |
@c Notes |
11 |
@c |
@c |
12 |
@c Remember to use "primitive" whereever appropriate. |
@c We no longer use the category "primitive" to distinguish C-defined |
13 |
@c FIXME: gotta change existing "subr" uses to "Primitive". |
@c Scheme procedures from those defined in Scheme. Instead, the |
14 |
@c [JimB:] In my text for the Guile snarfer, I've used the term "subr" |
@c reference manual now includes a C declaration as well as a Scheme |
15 |
@c to denote a C function made available to the Scheme world as a |
@c declaration for each procedure that is available in both Scheme and |
16 |
@c function. This terminology is weird, but consistent with the |
@c C. |
|
@c function names and also with Emacs Lisp, which I assume takes |
|
|
@c Maclisp's lead. |
|
17 |
@c |
@c |
18 |
@c When adding a new function to the Guile manual, please document |
@c When adding a new reference entry to the Guile manual, please |
19 |
@c it with @deffn as one of `primitive', `procedure', or `syntax'. |
@c document it with @deffn using one of the following categories: |
20 |
|
@c |
21 |
|
@c {Scheme Procedure} |
22 |
|
@c {Scheme Syntax} |
23 |
|
@c {C Function} |
24 |
|
@c {C Macro} |
25 |
|
@c |
26 |
|
@c If the entry is for a new primitive, it should have both a @deffn |
27 |
|
@c {Scheme Procedure} line and a @deffnx {C Function} line; see the |
28 |
|
@c manual source for plenty of existing examples of this. |
29 |
|
@c |
30 |
|
@c For {C Function} entries where the return type and all parameter |
31 |
|
@c types are SCM, we omit the SCMs. This is easier to read and also |
32 |
|
@c gets round the problem that Texinfo doesn't allow a @deftypefnx |
33 |
|
@c inside a @deffn. |
34 |
@c |
@c |
35 |
@c For a list of Guile primitives that are not yet incorporated into the |
@c For a list of Guile primitives that are not yet incorporated into the |
36 |
@c reference manual, see the file `new-docstrings.texi', which holds all |
@c reference manual, see the file `new-docstrings.texi', which holds all |
274 |
|
|
275 |
@include preface.texi |
@include preface.texi |
276 |
|
|
|
@c preliminary |
|
277 |
@iftex |
@iftex |
278 |
@page |
@page |
279 |
@unnumbered{Part I: Introduction to Guile} |
@unnumbered{Part I: Introduction to Guile} |
309 |
@include scheme-reading.texi |
@include scheme-reading.texi |
310 |
@include scheme-indices.texi |
@include scheme-indices.texi |
311 |
|
|
|
@c Unix system interface |
|
312 |
@iftex |
@iftex |
313 |
@page |
@page |
314 |
@unnumbered{Part III: Guile Modules} |
@unnumbered{Part III: Guile Modules} |