.. _Whitespace:

Whitespace
==========

-  **Trim end of line whitespace** (ro.amiq.vlogdt/format.whitespace.trim_end_of_line) - When enabled, end of line whitespace is deleted.

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

   * - Before
     - After
   * - .. figure:: ../../images/common/before-trim-end-of-line-whites.png
     - .. figure:: ../../images/common/after-trim-end-of-line-whites.png


-  **Trim Whitespace Lines** (ro.amiq.vlogdt/format.whitespace.trim_whitespace_line) - When enabled, whitespace line are deleted.

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

   * - Before
     - After
   * - .. figure:: ../../images/common/before-trim-whitespace-lines.png
     - .. figure:: ../../images/common/after-trim-whitespace-lines.png



-  **Compact whitespace groups** (ro.amiq.vlogdt/format.whitespace.compact) - When enabled, consecutive whitespace characters are trimmed to a single space character. It does not affect indentation, that is the whitespace at the beginning of a line is not affected by this option.

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

   * - Before
     - After
   * - .. figure:: ../../images/common/before-compact-whitespace-group.png
     - .. figure:: ../../images/common/after-compact-whitespace-group.png


-  **Compact consecutive empty lines** (ro.amiq.vlogdt/format.whitespace.compact_consecutive_empty_lines) - When enabled, consecutive empty lines are compacted into groups of lines whose number is less than or equal to a specified value. It does not affect the empty lines inside multi-line comments.
    -  **Maximum number of consecutive empty lines** (ro.amiq.vlogdt/format.whitespace.maximum_nof_consecutive_empty_lines) - Consecutive empty lines are compacted when their number exceeds this value.

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

   * - Before
     - After (Preference is set to "1")
   * - .. figure:: ../../images/common/before-compact-consecutive-empty-lines.png
     - .. figure:: ../../images/common/after-compact-consecutive-empty-lines.png

-  **Add whitespace before** (ro.amiq.vlogdt/format.whitespace.add_before) - Space separated list of tokens to add whitespace before.

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

   * - Before
     - After ("=" token)
   * - .. figure:: ../../images/common/before-add-whitespace-before.png
     - .. figure:: ../../images/common/after-add-whitespace-before.png


-  **Add whitespace after** (ro.amiq.vlogdt/format.whitespace.add_after) - Space separated list of tokens to add whitespace after.

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

   * - Before
     - After ("=" token)
   * - .. figure:: ../../images/common/before-add-whitespace-after.png
     - .. figure:: ../../images/common/after-add-whitespace-after.png

-  **Remove new line before** (ro.amiq.vlogdt/format.whitespace.remove_nl_before) - Space separated list of tokens to remove new lines before.

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

   * - Before
     - After ("=" token)
   * - .. figure:: ../../images/common/before-remove-new-line-before.png
     - .. figure:: ../../images/common/after-remove-new-line-before.png


-  **Remove new line after** (ro.amiq.vlogdt/format.whitespace.remove_nl_after) - Space separated list of tokens to remove new lines after.

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

   * - Before
     - After ("=" token)
   * - .. figure:: ../../images/common/before-remove-new-line-after.png
     - .. figure:: ../../images/common/after-remove-new-line-after.png


