add `for/splice` and `for*/splice` to docs

pull/174/head
Matthew Butterick 6 years ago
parent a3f1142dc6
commit a854e2ed7f

@ -1 +1 @@
1522128018 1522300233

@ -13,7 +13,7 @@ These functions are automatically imported into every Pollen source file (meanin
@section{Syntactic forms} @section{Metas}
@defform[(define-meta name value)] @defform[(define-meta name value)]
Add @racket[_value] to the metas of the current document, using @racket[_name] as the key. Add @racket[_value] to the metas of the current document, using @racket[_name] as the key.
@ -22,6 +22,9 @@ You can retrieve a meta value — even in the same document where you define it
For an introduction to metas, see @secref["Inserting_metas"]. For an introduction to metas, see @secref["Inserting_metas"].
@section{Splicing}
@defform[(\@ arg ...)] @defform[(\@ arg ...)]
Splicing tag: signals that a list should be merged into its containing expression. You can use something other than @racket[\@] by overriding @racket[setup:splicing-tag]. Splicing tag: signals that a list should be merged into its containing expression. You can use something other than @racket[\@] by overriding @racket[setup:splicing-tag].
@ -33,7 +36,6 @@ doc
] ]
@defform[(when/splice condition pollen-args)] @defform[(when/splice condition pollen-args)]
If @racket[_condition] is true, put the @racket[_pollen-args] into the document. Within a template file, usually invoked like so: If @racket[_condition] is true, put the @racket[_pollen-args] into the document. Within a template file, usually invoked like so:
@ -44,6 +46,13 @@ The inserted text can contain its own nested Pollen commands.
@racket[when/splice] can be more convenient than @racket[when], because @racket[when] will only use the last argument between the curly braces. @racket[when/splice], by contrast, treats everything between the curly braces as a block. @racket[when/splice] can be more convenient than @racket[when], because @racket[when] will only use the last argument between the curly braces. @racket[when/splice], by contrast, treats everything between the curly braces as a block.
@deftogether[(
@defform[(for/splice (for-clause ...) body-or-break ... body)]
@defform[(for*/splice (for-clause ...) body-or-break ... body)])]
Like @racket[for/list] and @racket[for*/list], but the resulting list is spliced into the document.
@section{Data helpers} @section{Data helpers}
Functions for retrieving data out of Pollen source files. These are not the only options  you can, of course, use any of the usual Racket functions. Functions for retrieving data out of Pollen source files. These are not the only options  you can, of course, use any of the usual Racket functions.

Loading…
Cancel
Save