Documentation suggestions / questions

[chrissound]

http://snapframework.com/docs/tutorials/heist

Whenever the bound tag is used, the template engine will substitute the ‘bind’ tag’s child nodes in its place.

When does this occur? renderTemplate?

The apply tag loads one of your application templates and inserts it into the current template’s node tree. If the target template does not have any special tags, then the contents of the apply tag are ignored.

When does this occur? What is the target template?

[mightybyte]

When does this occur? renderTemplate?

It depends on what kind of splice it is and whether you're using interpreted or compiled mode.

In interpreted mode it happens at renderTemplate. In compiled mode, if it's a load-time splice, that happens in initHeist. For compiled splices it happens in renderTemplate.

When does this occur? What is the target template?

The apply tag is a splice like any other splice.

http://hackage.haskell.org/package/heist-1.0.1.0/docs/Heist-Splices-Apply.html

In interpreted mode, it's just a normal splice. In compiled mode, it is a load-time splice.