C and C++ can be documented with Doxygen_, using the subset of Doxygen
markup supported by Breathe_.
-.. _Doxygen: http://www.stack.nl/~dimitri/doxygen/
+.. _Doxygen: http://www.doxygen.nl/
.. _Breathe: https://github.com/michaeljones/breathe
The general format for function documentation is::
When `cephx`_ is enabled (it is by default), you must specify a user name or ID
and a path to the keyring containing the corresponding key for the user. See
-`User Management`_ for details. You may also add the ``CEPH_ARGS`` environment
+:ref:`User Management <user-management>` for details. You may also add the ``CEPH_ARGS`` environment
variable to avoid re-entry of the following parameters. ::
rbd --id {user-ID} --keyring=/path/to/secret [commands]
.. _cephx: ../../rados/configuration/auth-config-ref/
-.. _User Management: ../../operations/user-management
.. _QEMU: ../qemu-rbd/
.. _OpenStack: ../rbd-openstack/
.. _CloudStack: ../rbd-cloudstack/