book icon indicating copy to clipboard operation
book copied to clipboard

Add supporting documentation for Macros

Open Corallus-Caninus opened this issue 3 years ago • 2 comments
trafficstars

  • [x] I have checked the latest main branch to see if this has already been fixed
  • [x] I have searched existing issues and pull requests for duplicates

URL to the section(s) of the book with this problem: https://doc.rust-lang.org/book/ch19-06-macros.html Description of the problem: Macros have always been underdocumented in the book which is outstanding otherwise. While Macros may be too much to cover all at once in the book I think further docmentation should be referenced. Suggested fix: Add an appendix with https://github.com/dtolnay/proc-macro-workshop and https://danielkeep.github.io/tlborm/book/README.html referenced for further reading to prevent sending programmers on a search campaign for more information.

Corallus-Caninus avatar Oct 02 '22 22:10 Corallus-Caninus

The Little Book of Rust Macros is already referenced (and there's a newer version, it's no longer maintained by Daniel Keep).

I'll consider whether to add a reference to the proc macro workshop, though. Thanks!

carols10cents avatar Oct 03 '22 02:10 carols10cents

Thanks I had the sneaking suspicion I forgot something. I'll let you close this than.

Corallus-Caninus avatar Oct 05 '22 20:10 Corallus-Caninus