.. _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-vhdl.png
     - .. figure:: ../../images/common/disable-formatter-after-without-pragma-vhdl.png
     - .. figure:: ../../images/common/disable-formatter-after-with-pragma-vhdl.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-vhdl.png
     - .. figure:: ../../images/common/skip-formatter-after-without-pragma-vhdl.png
     - .. figure:: ../../images/common/skip-formatter-after-with-pragma-vhdl.png

