Add The Little Book of Rust Macros (WIP)

build.sh

@@ -4,3 +4,4 @@ RUN="cargo run --release --"
 
 $RUN --prefix=trpl --source=trpl --meta=trpl_meta.yml && \
 $RUN --prefix=nomicon --source=nomicon --meta=nomicon_meta.yml
+$RUN --prefix=tlborm --source=tlborm --meta=tlborm_meta.yml

src/convert_book/options.rs

@@ -1,4 +1,4 @@
-pub const RELEASE_DATE: &'static str = "2015-09-26";
+pub const RELEASE_DATE: &'static str = "2015-10-14";
 
 pub const MARKDOWN: &'static str = "markdown+grid_tables+pipe_tables-simple_tables+raw_html+implicit_figures+footnotes+intraword_underscores+auto_identifiers-inline_code_attributes";
 

tlborm/README.md

@@ -0,0 +1,15 @@
+% The Little Book of Rust Macros
+
+**Note**: this is a work in progress.
+
+This book is an attempt to distil the Rust community's collective knowledge of Rust macros.  As such, both additions (in the form of pull requests) and requests (in the form of issues) are welcome.
+
+If you wish to contribute, see [the GitHub repository](https://github.com/DanielKeep/tlborm/).
+
+## Thanks
+
+Thanks to the following for suggestions and corrections: IcyFoxy, Rym, TheMicroWorm, Yurume, akavel, cmr, ogham, and snake_case.
+
+## License
+
+This work is licensed under both the [Creative Commons Attribution-ShareAlike 4.0 International License](http://creativecommons.org/licenses/by-sa/4.0/) and the [MIT license](http://opensource.org/licenses/MIT).

tlborm/SUMMARY.md

@@ -0,0 +1,31 @@
+# Summary
+
+* [Macros, A Methodical Introduction](mbe-README.md)
+    * [Syntax Extensions](mbe-syn-README.md)
+        * [Source Analysis](mbe-syn-source-analysis.md)
+        * [Macros in the AST](mbe-syn-macros-in-the-ast.md)
+        * [Expansion](mbe-syn-expansion.md)
+    * [macro_rules!](mbe-macro-rules.md)
+    * [Minutiae](mbe-min-README.md)
+        * [Captures and Expansion Redux](mbe-min-captures-and-expansion-redux.md)
+        * [Hygiene](mbe-min-hygiene.md)
+        * [Non-Identifier Identifiers](mbe-min-non-identifier-identifiers.md)
+        * [Debugging](mbe-min-debugging.md)
+        * [Scoping](mbe-min-scoping.md)
+        * [Import/Export](mbe-min-import-export.md)
+* [Macros, A Practical Introduction](pim-README.md)
+* [Patterns](pat-README.md)
+    * [Callbacks](pat-callbacks.md)
+    * [Incremental TT Munchers](pat-incremental-tt-munchers.md)
+    * [Internal Rules](pat-internal-rules.md)
+    * [Push-Down Accumulation](pat-push-down-accumulation.md)
+    * [Repetition Replacement](pat-repetition-replacement.md)
+    * [Trailing Separators](pat-trailing-separators.md)
+    * [TT Bundling](pat-tt-bundling.md)
+    * [Provisional](pat-provisional.md)
+* [Building Blocks](blk-README.md)
+    * [AST Coercion](blk-ast-coercion.md)
+    * [Counting](blk-counting.md)
+    * [Enum Parsing](blk-enum-parsing.md)
+* [Annotated Examples](aeg-README.md)
+    * [Ook!](aeg-ook.md)

tlborm/aeg-README.md

@@ -0,0 +1,5 @@
+% Annotated Examples
+
+This section contains real-world[^*] macros which have been annotated to explain their design and construction.
+
+[^*]: For the most part.