Issues with scope-documentation - Githubissues

JuliaLang / julia

The Julia Programming Language

https://julialang.org/

MIT License

45.58k stars 5.48k forks source link

Issues with scope-documentation #14903

Open mauro3 opened 8 years ago

mauro3 commented 8 years ago

PR #12146 overhauled the scope documentation but the following issues were left for another day:

[ ] description of let could use some love. In particular it is not quite clear what the difference is between introducing variables in its head vs. body.
[ ] macros could probably do with an example and a link to the somewhat related topic of hygiene
[ ] section on "Constants" seems a bit out of place. But where to move it?
[ ] some description of or link to scope-doc for parallel programs

Edit: these are not pressing.

mauro3 commented 8 years ago

This issue raises some of the parallel programming subtleties: https://github.com/JuliaLang/julia/issues/14948