From cc2f7d02a17b26cd3163b802cd738b5f7f33ced6 Mon Sep 17 00:00:00 2001 From: Matthew Butterick Date: Fri, 29 Jan 2016 11:12:11 -0800 Subject: [PATCH] add comment --- pollen/core.rkt | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/pollen/core.rkt b/pollen/core.rkt index 7a17679..7504d19 100644 --- a/pollen/core.rkt +++ b/pollen/core.rkt @@ -103,6 +103,13 @@ (cached-doc (convert+validate-path pagenode-or-path 'get-doc))) +;; This `@` definition is here to provide a hook for the docs. +;; But this is just default tag behavior, and thus would work without the definition. +;; Which is why the splicing tag can be renamed: +;; it just becomes an undefined tag, also with default behavior. +;; For a pollen source, the actual splicing happens when the source is compiled. +;; For a template in the render environment, which is more text-ish, +;; the splicing tag is redefined to produce a basic list. (define+provide @ (make-default-tag-function '@)) (provide when/splice)