Macro hygiene and the guides


#1

According to http://doc.rust-lang.org/guide-macros.html#hygiene, macros have hygiene, but https://github.com/rust-lang/rust/issues/19700 indicates that they are only hygienic for let names.

I’m guessing fixing this will come after 1.0, but should we fix the hygiene section in the guide http://doc.rust-lang.org/guide-macros.html#hygiene to at least explain the limitations of the current implementation?

I’ve been bitten by this when trying to work around it by using full paths to refer to the name, but discovering that the path isn’t the same inside the module as it is when used in other modules. See https://github.com/d3zd3z/macromod for a kind of minimized example.


#2

I’ve been waiting on reform to land before I redid these docs. PRs very welcome.