===============================
Profiling (conditional content)
===============================

Installation Guides has content that depends upon the operating
systems.

Use the ``only`` directive to specify the content that is operating-system
specific. Define one or several tags depending on the operating system
the content belongs to. Make sure to close the ``only`` tag with ``endonly``.

The valid tags for the ``only`` directive are:

* ``ubuntu`` for Ubuntu
* ``debian`` for Debian
* ``rdo`` for Red Hat Enterprise Linux and CentOS
* ``obs`` for openSUSE and SUSE Linux Enterprise

.. note::

  The ``endonly`` tag allows the parser to identify the distro-specific blocks.
  For more information, refer to the :doc:`rst2bash` section. These
  changes are mandatory only for the installation guides.

**Input**

.. code-block:: none

   Install the NTP service
   -----------------------

   .. only:: ubuntu or debian

      .. code-block:: console

         # apt-get install chrony

      .. end

   .. endonly

   .. only:: rdo

      .. code-block:: console

         # yum install chrony

      .. end

   .. endonly

   .. only:: obs

      On openSUSE:

      .. code-block:: console

         # zypper addrepo http://download.opensuse.org/repositories/network:time/openSUSE_13.2/network:time.repo
         ...

      .. end

      On SLES:

      .. code-block:: console

         # zypper addrepo http://download.opensuse.org/repositories/network:time/SLE_12/network:time.repo
         ...

      .. end

   .. endonly

For more details refer to `Including content based on tags
<http://sphinx.readthedocs.org/en/latest/markup/misc.html?highlight=only%20directive#including-content-based-on-tags>`_.