---

yaml
---
r: 39239
b: refs/heads/incoming
c: 3af7576
h: refs/heads/master
i:
  39237: 91838fd
  39235: 2f55a22
  39231: 7d36f5d
v: v3

Author: paulstansifer

[refs]

@@ -6,7 +6,7 @@ refs/heads/try: 3d5418789064fdb463e872a4e651af1c628a3650
 refs/tags/release-0.1: 1f5c5126e96c79d22cb7862f75304136e204f105
 refs/heads/ndm: f3868061cd7988080c30d6d5bf352a5a5fe2460b
 refs/heads/try2: a810c03263670238bccd64cabb12a23a46e3a278
-refs/heads/incoming: b84caefdbc8882bb15f35cb48d765d028bf530ac
+refs/heads/incoming: 3af757631e1d1aca2fbf890a122123b638341633
 refs/heads/dist-snap: 22efa39382d41b084fde1719df7ae8ce5697d8c9
 refs/tags/release-0.2: c870d2dffb391e14efb05aa27898f1f6333a9596
 refs/tags/release-0.3: b5f0d0f648d9a6153664837026ba1be43d3e2503

branches/incoming/doc/tutorial-macros.md

@@ -117,6 +117,12 @@ transcriber (therefore `() => ((1,2,3))` is a macro that expands to a tuple
 expression, `() => (let $x=$val)` is a macro that expands to a statement, and
 `() => (1,2,3)` is a macro that expands to a syntax errror).
 
+Except for permissibility of `$name` (and `$(...)*`, discussed below), the
+right-hand side of a macro definition follows the same rules as ordinary
+Rust syntax. In particular, macro invocations (including invocations of the
+macro currently being defined) are permitted in expression, statement, and
+item locations.
+
 ## Interpolation location
 
 The interpolation `$argument_name` may appear in any location consistent with