.. index::
   pair: sphinx ; pair
   pair: sphinx important; contents


.. _sphinx_pair:


======================
pair (very important)
======================


``pair: loop; statement`` is a shortcut that creates two index entries,
namely ``loop; statement`` and ``statement; loop``.


Example::

    .. index::
       pair: sphinx ; pair
       pair: sphinx important; contents