diff options
author | Andy Wingo <wingo@pobox.com> | 2009-01-08 22:05:59 +0100 |
---|---|---|
committer | Andy Wingo <wingo@pobox.com> | 2009-01-08 22:05:59 +0100 |
commit | 00ce5125837c139ecd80f2f056b63ffdef4b9332 (patch) | |
tree | bc2841099b7075248e324fe47d9f949020e95240 /doc/ref/api-procedures.texi | |
parent | 9ff56d9e65fa9292ef09a8ca01abd825147b37ac (diff) | |
download | guile-00ce5125837c139ecd80f2f056b63ffdef4b9332.tar.gz |
start at documenting the compiler
* doc/ref/api-evaluation.texi: Add documentation for the standard
compilation interface, and some notes about compiled files.
* doc/ref/api-procedures.texi (Compiled Procedures): A stub at
documenting compiled procedures.
* doc/ref/compiler.texi (Compiling to the Virtual Machine): Flesh out
with some structure, though much of the text remains to be written.
This stuff is hard to write!
Diffstat (limited to 'doc/ref/api-procedures.texi')
-rw-r--r-- | doc/ref/api-procedures.texi | 16 |
1 files changed, 16 insertions, 0 deletions
diff --git a/doc/ref/api-procedures.texi b/doc/ref/api-procedures.texi index 7fd0f4fa4..fd3a8d15b 100644 --- a/doc/ref/api-procedures.texi +++ b/doc/ref/api-procedures.texi @@ -11,6 +11,7 @@ @menu * Lambda:: Basic procedure creation using lambda. * Primitive Procedures:: Procedures defined in C. +* Compiled Procedures:: Scheme procedures can be compiled. * Optional Arguments:: Handling keyword, optional and rest arguments. * Procedure Properties:: Procedure properties and meta-information. * Procedures with Setters:: Procedures with setters. @@ -131,6 +132,21 @@ use @code{scm_c_make_subr} and also @code{scm_makcclo} if necessary. It is advisable to use the gsubr variants since they provide a slightly higher-level abstraction of the Guile implementation. +@node Compiled Procedures +@subsection Compiled Procedures + +Procedures that were created when loading a compiled file are +themselves compiled. (In contrast, procedures that are defined by +loading a Scheme source file are interpreted, and often not as fast as +compiled procedures.) + +Loading compiled files is the normal way that compiled procedures come +to being, though procedures can be compiled at runtime as well. +@xref{Read/Load/Eval/Compile}, for more information on runtime +compilation. + +here document things from (system vm program) + @node Optional Arguments @subsection Optional Arguments |