/[guile]/guile/guile-core/doc/ref/guile.texi
ViewVC logotype

Diff of /guile/guile-core/doc/ref/guile.texi

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

revision 1.6 by ossau, Sun Nov 11 15:01:51 2001 UTC revision 1.7 by ossau, Sat Dec 1 15:53:04 2001 UTC
# Line 7  Line 7 
7  @set MANUAL_EDITION 1.1  @set MANUAL_EDITION 1.1
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
# Line 26  Line 38 
38  @c that are not in the reference manual.  If you have worked with some  @c that are not in the reference manual.  If you have worked with some
39  @c of these concepts, implemented them, or just happen to know what they  @c of these concepts, implemented them, or just happen to know what they
40  @c do, please write up a little explanation -- it would be a big help.  @c do, please write up a little explanation -- it would be a big help.
41  @c Alternatively, if you know of a great reason why some of these should  @c Alternatively, if you know of any reason why some of these should
42  @c *not* go in the manual, please let me know.  @c *not* go in the manual, please let the mailing list
43    @c <guile-devel@gnu.org> know.
44    
45  @c Define indices that are used in the Guile Scheme part of the  @c Define indices that are used in the Guile Scheme part of the
46  @c reference manual to group stuff according to whether it is R5RS or a  @c reference manual to group stuff according to whether it is R5RS or a
# Line 237  Part IV: Guile Modules Line 250  Part IV: Guile Modules
250  * Value History::               Maintaining a value history in the REPL.  * Value History::               Maintaining a value history in the REPL.
251  * Pretty Printing::             Nicely formatting Scheme objects for output.  * Pretty Printing::             Nicely formatting Scheme objects for output.
252  * Formatted Output::            The @code{format} procedure.  * Formatted Output::            The @code{format} procedure.
253    * Rx Regexps::                  The Rx regular expression library.
254  * Expect::                      Controlling interactive programs with Guile.  * Expect::                      Controlling interactive programs with Guile.
255  * The Scheme shell (scsh)::     Using scsh interfaces in Guile.  * The Scheme shell (scsh)::     Using scsh interfaces in Guile.
256    

Legend:
Removed from v.1.6  
changed lines
  Added in v.1.7

savannah-hackers-public@gnu.org
ViewVC Help
Powered by ViewVC 1.1.26