* doc/pmacros.texi (.splice): Add more text.

diff --git a/ChangeLog b/ChangeLog
index 8a4700863bfef6bebc5e6770dff19f208d0af398..1fe6b7cc17232e6125a036d5d0afef38550b6744 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,7 @@
+2009-08-20  Doug Evans  <dje@sebabeach.org>
+
+       * doc/pmacros.texi (.splice): Add more text.
+
 2009-08-19  Doug Evans  <dje@sebabeach.org>
 
        * configure.in (AM_INIT_AUTOMAKE): Change version to 1.1.50 to

diff --git a/doc/pmacros.texi b/doc/pmacros.texi
index 162bd7648fa9d84a11e7c2ac16fbb3fac175ada0..adf0bc0db271bc8213097cf638c31a61b02409f6 100644 (file)
--- a/doc/pmacros.texi
+++ b/doc/pmacros.texi
@@ -480,10 +480,10 @@ Examples:
 Builtin macros for maninpulating lists.
 
 @menu
-* Creating lists::
+* Creating lists::                The @code{.list} builtin
 * List splicing::                 The @code{.splice} builtin
 * Referencing a list element::    The @code{.ref} builtin
-* List length::
+* List length::                   The @code{.length} builtin
 * Lists of repeated elements::    The @code{.replicate} builtin
 * Finding a subset of a list::    The @code{.find} builtin
 * car/cdr::                       car, cdr, etc. from Scheme/Lisp
@@ -504,6 +504,9 @@ It's somewhat redundant as lists can also be created simply writing
 @subsection List splicing
 @cindex .splice
 
+Syntax: @samp{(.splice [expr1] [expr2] [(.unsplice list1)]
+              [(.unsplice list2)] [expr3] ...)}
+
 It is often useful to splice a list into a "parent" list.
 This is best explained with an example.
 
@@ -580,7 +583,14 @@ and
 respectively, which is what @code{.splice} achieves.
 
 @code{.unsplice} is a special reserved symbol that is only recognized inside
-@code{.splice}.
+@code{.splice}.  There can be any number of @code{.unsplice} expressions
+in a @code{.splice} but they all must be at the ``top level''.
+
+I.e. this is not supported:
+@samp{(.splice 1 (2 3 (.unsplice (4 5))))}.
+
+Note that @code{.splice} without any @code{.unsplice} expressions
+behaves identically to @code{.list}.
 
 @node Referencing a list element
 @subsection Referencing a list element