docs/tutorial: Add a short (require) example

Adds a short (require) example, along with a few words on why macros can't be imported.

Closes #966.

Signed-off-by: Csilla Nagyne Martinak <csilla@csillger.hu>
This commit is contained in:
Csilla Nagyne Martinak 2015-10-17 13:32:01 +02:00
parent b875feccff
commit d79e56f2ef

View File

@ -557,10 +557,21 @@ characters that soon):
=> #↻(1 2 3 +)
6
Macros are useful when one wished to extend the Hy or write their own
Macros are useful when one wishes to extend the Hy or write their own
language on top of that. Many features of Hy are macros, like ``when``,
``cond`` and ``->``.
To use macros defined in a different module, it is not enough to
``import`` the module, because importing happens at run-time, while we
would need macros at compile-time. Instead of importing the module
with macros, it must be ``require``d:
.. code-block:: clj
=> (require tutorial.macros)
=> (rev (1 2 3 +))
6
Hy <-> Python interop
=====================