Add a short documentation for use

[weppos]

I was reading the "Getting started" guide and one of the things I noticed is that the section where require, alias and import are documented doesn't include any explanation for use. In fact, use is not mentioned at all in the entire getting started guide.

I know import, require and alias are SpecialForm whereas use is defined as Kernel macro, however it's not uncommon to see new users confused by this specific keyword: see here and here.

This branch takes bits and pieces from the answers above and the use/2 documentation, and adds a new section in the "getting started" to explain the purpose of use.

What do you think?

[josevalim]

THank you! @weppos the issue is that use is not necessarily lexically scoped as everything else. So maybe we could add this to the end of the chapter and start with something like you described: "Although not a directive, use is a macro tightly related to require, after all [current description]". What do you think?

[weppos]

Fine for me. Changing it now.

[weppos]

Done. Give it a look and let me know if it works for you.

[josevalim]

Extra line.

[weppos]

It was probably added in the cut&paste. Removing it...

[josevalim]

I have added two more comments and we are good to go. :)

[weppos]

Here we go. Thanks for your feedback.

[josevalim]

❤️ 💚 💙 💛 💜