.. _Disable Format for Code Sections:

Disable Format for Code Sections
================================

.. rst-class:: lead

When format is disabled, a code section is completely ignored, that is it is not formatted, nor it contributes to formatting.

- **Disable format for a code section** - Code sections between the **@formatter:off** and **@formatter:on** pragmas are not formatted.

.. list-table::
  :header-rows: 1
  :widths: auto

  * - Initial code
    - Code Formatted without "on"/"off" pragmas
    - Code Formatted with "on"/"off" pragmas
  * - .. figure:: ../../images/common/disable-formatter-before.png
    - .. figure:: ../../images/common/disable-formatter-after-without-pragma.png
    - .. figure:: ../../images/common/disable-formatter-after-with-pragma.png


- **Disable format for a single line** - Lines containing the **@fomatter:skip** pragma inside a comment are not formatted.

.. list-table::
  :header-rows: 1
  :widths: auto

  * - Initial code
    - Code Formatted without skip pragma
    - Code Formatted with skip pragma
  * - .. figure:: ../../images/common/skip-formatter-before.png
    - .. figure:: ../../images/common/skip-formatter-after-without-pragma.png
    - .. figure:: ../../images/common/skip-formatter-after-with-pragma.png

