Packages
--------

CLDomain, like Common Lisp, needs to know the current package when resolving symbols. The
``:cl:package:`` directive is the CLDomain equivalent of ``(in-package ...)``. You can switch
between packages at any time in the documentation file using this directive.

.. rst:directive:: .. cl:package:: package

   Use ``package`` as the package name when resolving symbols to documentation::

      .. cl:package:: sphinxcontrib.cldomain.doc

   For multi-package documentation in the same Sphinx documentation file::

      .. cl:package:: sphinxcontrib.cldomain.doc

      documentation... documentation... documentation...

      .. cl:package:: org.coolness.my.code

      foo... bar... baz... lemon odor quux!!!


.. cl:package:: sphinxcontrib.cldomain.doc