Overhaul the macro and variable documentation #1519

editions/tw5.com/tiddlers/macros/syntax/MacroCallSyntax.tid

@@ -0,0 +1,27 @@
+created: 20150221105732000
+modified: 20150221222352000
+tags: [[Macro Syntax]]
+title: Macro Call Syntax
+type: text/vnd.tiddlywiki
+
+<<.preamble """What follows is a formal presentation of the syntax of the WikiText syntax for macro calls, using [[railroad diagrams|Railroad Diagrams]]. A [[simpler overview|Macro Calls in WikiText]] is also available.""">>
+
+<$railroad text="""
+"<<" name [: space [:{param-value}] ]">>"
+"""/>
+
+<<.place space>> denotes a sequence of [[whitespace characters|Filter Whitespace]].
+
+The [[macro|Macros]]'s <<.place name>> is a sequence of non-whitespace characters other than `(` or `>`.
+
+Each individual <<.place param-value>> has the following syntax:
+
+<$railroad text="""
+[: param-name [:space] ":" [:space] ] value [: space]
+"""/>
+
+The <<.place param-name>> is a sequence of letters (`A`--`Z`, `a`--`z`), digits (`0`--`9`), hyphens (`-`) and underscores (`_`).
+
+The <<.place value>> is specified as follows:
+
+<$railroad text={{$:/editions/tw5.com/railroad/macro-parameter-value}}/>

editions/tw5.com/tiddlers/macros/syntax/MacroDefinitionSyntax.tid

@@ -0,0 +1,52 @@
+created: 20150220200255000
+modified: 20150221222349000
+tags: [[Macro Syntax]]
+title: Macro Definition Syntax
+type: text/vnd.tiddlywiki
+
+<<.preamble """What follows is a formal presentation of the syntax of the `\define` pragma, using [[railroad diagrams|Railroad Diagrams]]. A [[simpler overview|Macro Definitions in WikiText]] is also available.""">>
+
+<$railroad text="""
+"\define" space name params [:space] rest
+"""/>
+
+<<.place space>> denotes a sequence of [[whitespace characters|Filter Whitespace]].
+
+The [[macro|Macros]]'s <<.place name>> is a sequence of non-whitespace characters other than `(` or `>`.
+
+The parameter declaration list (<<.place params>>) has the following syntax:
+
+<$railroad text="""
+"(" [:sep] [:{ param sep }] ")"
+"""/>
+
+The parameter separator (<<.place sep>>) is any sequence of characters that does not match a <<.place param-name>>. Among other things, this includes commas, spaces and linefeeds.
+
+A <<.place param-name>> is a sequence of letters (`A`--`Z`, `a`--`z`), digits (`0`--`9`), hyphens (`-`) and underscores (`_`).
+
+Each individual <<.place param>> has the following syntax:
+
+<$railroad text="""
+param-name [: [:space] ":" [:space] default ]
+")"
+"""/>
+
+The optional <<.place default>> value of a parameter is specified as follows:
+
+<$railroad text={{$:/editions/tw5.com/railroad/macro-parameter-value}}/>
+
+The <<.place rest>> of the definition has the following syntax:
+
+<$railroad text="""
+( snippet | lf snippet lf "\end" [:space] ) lf
+"""/>
+
+<<.place lf>> denotes a linefeed.
+
+The <<.place snippet>> is any sequence of characters that doesn't terminate the macro definition. That is to say, a single-line snippet cannot contain a linefeed, and a multi-line snippet cannot contain `\end` on a line of its own.
+
+The snippet can contain placeholders with the following syntax:
+
+<$railroad text="""
+( "$" name "$" | "$" "(" name ")" "$" )
+"""/>

editions/tw5.com/tiddlers/macros/syntax/MacroParameterValue.tid

@@ -0,0 +1,11 @@
+created: 20150220191009000
+modified: 20150221111554000
+title: $:/editions/tw5.com/railroad/macro-parameter-value
+type: text/vnd.tiddlywiki.railroad
+
+( '"""' [:{/'anything but """'/}] '"""'
+| '"'   [:{/'anything but "'/}]   '"'
+| "'"   [:{/"anything but '"/}]   "'"
+| "[["  [:{/"anything but ]"/}]   "]]"
+| {/"""anything but ' " or whitespace"""/}
+)

editions/tw5.com/tiddlers/macros/syntax/MacroSyntax.tid

@@ -0,0 +1,6 @@
+created: 20150221222254000
+modified: 20150221222354000
+tags: Macros
+title: Macro Syntax
+
+<<list-links filter="[tag[Macro Syntax]]">>