summaryrefslogtreecommitdiff
path: root/doc/ref/api-debug.texi
diff options
context:
space:
mode:
authorAndy Wingo <wingo@pobox.com>2010-03-19 12:30:31 +0100
committerAndy Wingo <wingo@pobox.com>2010-03-19 12:30:38 +0100
commit1fc8dcc7ac6a83ae6586e02491784954e3be94ef (patch)
tree87277ede10d3f5b0d53dadcb0460190c4f719206 /doc/ref/api-debug.texi
parenta6e60a9571711cf90ec9cf547125cb1495e58bca (diff)
downloadguile-1fc8dcc7ac6a83ae6586e02491784954e3be94ef.tar.gz
document syntax-case
* doc/ref/api-macros.texi: Document syntax-case, and tweak defmacro docs. * doc/ref/api-debug.texi: Move cons-source here.
Diffstat (limited to 'doc/ref/api-debug.texi')
-rw-r--r--doc/ref/api-debug.texi11
1 files changed, 11 insertions, 0 deletions
diff --git a/doc/ref/api-debug.texi b/doc/ref/api-debug.texi
index 747ac45d1..37a5b21ab 100644
--- a/doc/ref/api-debug.texi
+++ b/doc/ref/api-debug.texi
@@ -256,6 +256,17 @@ If the @code{positions} reader option is enabled, each parenthesized
expression will have values set for the @code{filename}, @code{line} and
@code{column} properties.
+If you're stuck with defmacros (@pxref{Defmacros}), and want to preserve
+source information, the following helper function might be useful to
+you:
+
+@deffn {Scheme Procedure} cons-source xorig x y
+@deffnx {C Function} scm_cons_source (xorig, x, y)
+Create and return a new pair whose car and cdr are @var{x} and @var{y}.
+Any source properties associated with @var{xorig} are also associated
+with the new pair.
+@end deffn
+
@node Starting a New Stack
@subsubsection Starting a New Stack