Adding Dynamic Names

man/mustache.5.ron

@@ -39,7 +39,7 @@ replaced with a value, some nothing, and others a series of
 values. This document explains the different types of Mustache tags.
 
 The Mustache language has a [formal specification][spec]. The current
-manpage reflects version 1.2.1 of the specification, including the
+manpage reflects version 1.3.0 of the specification, including the
 official-but-optional extensions for lambdas and inheritance.
 
 [spec]: https://github.com/mustache/spec
@@ -411,6 +411,36 @@ Can be thought of as a single, expanded template:
     {{/names}}
 
 
+**Dynamic Names**
+
+Partials can be loaded dynamically at runtime using Dynamic Names; an
+**optional** part of the Mustache specification which allows to dynamically
+determine a tag's content at runtime.
+
+Dynamic Names consists of an asterisk, followed by a dotted name which follows
+the same notation and the same resolution as in an variable tag. That is
+`{{>*dynamic}}`. It can be thought as the following **hypothetical** tag
+(which is **not allowed**!): `{{>{{dynamic}}}}`.
+
+Templates:
+
+    main.mustache:
+    Hello {{>*dynamic}}
+
+    world.template:
+    everyone!
+
+Hash:
+
+    {
+      "dynamic": "world"
+    }
+
+Output:
+
+    Hello everyone!
+
+
 ### Blocks
 
 A block begins with a dollar and ends with a slash. That is, `{{$title}}`
@@ -484,6 +514,35 @@ Output, assuming the `article.mustache` from before:
     <h1>Yesterday</h1>
     <p>Nothing special happened.</p>
 
+**Dynamic Names**
+
+Some mustache implementations may allow the use of Dynamic Names in
+parent tags, similar to dynamic names in partials. Here's an example of
+how Dynamic Names in parent tags work.
+
+Templates:
+
+    {{!normal.mustache}}
+    {{$text}}Here goes nothing.{{/text}}
+
+    {{!bold.mustache}}
+    <b>{{$text}}Here also goes nothing but it's bold.{{/text}}</b>
+
+    {{!dynamic.mustache}}
+    {{<*dynamic}}
+      {{$text}}Hello World!{{/text}}
+    {{/*dynamic}}
+
+Hash:
+
+    {
+      "dynamic": "bold"
+    }
+
+Output:
+
+    <b>Hello World!</b>
+
 
 ### Set Delimiter