diff options
author | Andy Wingo <wingo@pobox.com> | 2010-08-12 13:04:08 +0200 |
---|---|---|
committer | Andy Wingo <wingo@pobox.com> | 2010-08-16 21:36:14 -0700 |
commit | 7545ddd42a065da0d50b2d84e7889aeb5d71326b (patch) | |
tree | 61a0709f1389e41cce765f5f1ca9634ac9180cea /doc/ref/api-procedures.texi | |
parent | 46088b26299cf427cd887c6289ea564ec33ecffb (diff) | |
download | guile-7545ddd42a065da0d50b2d84e7889aeb5d71326b.tar.gz |
a number of doc fixes
* doc/ref/api-control.texi (Handling Errors): Update docs for
display-error.
* libguile/backtrace.h (scm_i_display_error): Change prototype to
s/stack/frame/.
* libguile/throw.c (handler_message): Change invocation of
scm_i_display_error to pass a frame.
* doc/ref/api-deprecated.texi (Deprecation): Update wording.
* doc/ref/api-evaluation.texi (Local Evaluation): Remove section on
local-eval.
* doc/ref/api-macros.texi: Fix a couple typos.
* doc/ref/api-memory.texi (Objects): Remove terrible section.
* doc/ref/api-procedures.texi (Procedure Properties): Remove docs for
closure?.
(Compiled Procedures): Update wording.
* doc/ref/guile.texi (API Reference): Remove reference to "Objects".
Diffstat (limited to 'doc/ref/api-procedures.texi')
-rw-r--r-- | doc/ref/api-procedures.texi | 27 |
1 files changed, 7 insertions, 20 deletions
diff --git a/doc/ref/api-procedures.texi b/doc/ref/api-procedures.texi index 0b0acf7f7..8fc7f33f5 100644 --- a/doc/ref/api-procedures.texi +++ b/doc/ref/api-procedures.texi @@ -121,22 +121,18 @@ same way as @code{scm_c_make_gsubr}, which is usually not further required. @end deftypefun -@code{scm_c_make_gsubr} and @code{scm_c_define_gsubr} automatically -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 -In Guile, procedures can be executed by directly interpreting their -source code. Scheme source code is a set of nested lists, after all, -with each list representing a procedure call. +The evaluation strategy given in @ref{Lambda} describes how procedures +are @dfn{interpreted}. Interpretation operates directly on expanded +Scheme source code, recursively calling the evaluator to obtain the +value of nested expressions. Most procedures are compiled, however. This means that Guile has done -some pre-computation on the procedure, to determine what it will need -to do each time the procedure runs. Compiled procedures run faster -than interpreted procedures. +some pre-computation on the procedure, to determine what it will need to +do each time the procedure runs. Compiled procedures run faster than +interpreted procedures. Loading files is the normal way that compiled procedures come to being. If Guile sees that a file is uncompiled, or that its compiled @@ -599,15 +595,6 @@ returns @code{#t} for procedures which do not accept any arguments. Return @code{#t} if @var{obj} is a procedure. @end deffn -@deffn {Scheme Procedure} closure? obj -@deffnx {C Function} scm_closure_p (obj) -Return @code{#t} if @var{obj} is a closure. This category somewhat -misnamed, actually, as it applies only to interpreted procedures, not -compiled procedures. But since it has historically been used more to -select on implementation details than on essence (closure or not), we -keep it here for compatibility. Don't use it in new code, though. -@end deffn - @deffn {Scheme Procedure} thunk? obj @deffnx {C Function} scm_thunk_p (obj) Return @code{#t} if @var{obj} is a thunk. |