Skip to content

Commit 59e00dd

Browse files
committed
Added a section about soft tabs and hard tabs
1 parent c3d9c26 commit 59e00dd

File tree

1 file changed

+10
-1
lines changed

1 file changed

+10
-1
lines changed

index.rst

Lines changed: 10 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -60,6 +60,15 @@ In EditorConfig:
6060
settings based on the key-value pairs.
6161
- "Editors" permit editing files, and use plugins to update settings for
6262
files being edited.
63+
- The words "tab" and "hard tab" are interchangable and represent the
64+
character defined by the Unicode HT/TAB symbol (U+0009).
65+
- The word "space" is the Unicode character defined by the Unicode Space/SP symbol (U+0020).
66+
- "Column" is an abstract atomic unit of indentation. A single space, as defined above, is expected
67+
to contribute exactly one column to the indentation of a given line. The amount of columns
68+
contributed by the hard tab depends on the configuration pairs defined in the :ref:`supported-pairs` section.
69+
- The term "soft tab" represents the numerous amount (1..N) of sequential space characters, which,
70+
when considered together, form an indentation level that has a length equal to the length of a single
71+
hard tab. The length of both the soft tab and a hard tab is measured in columns.
6372

6473
A conforming core or plugin must pass the tests in the
6574
`core-tests repository`_ or `plugin-tests repository`_, respectively.
@@ -332,7 +341,7 @@ section to specify their behavior. Consider the following code snippet:
332341
333342
The ``indent_size`` setting for this code snippet equals 4, because ``indent_size`` means how many columns are required
334343
to indent the next line in relation to previous (if indentation, of course, is applicable for this line). Then the next question
335-
is *how* this indentation of 4 columns is achieved. It may be 4 consequent spaces/soft tabs,
344+
is *how* this indentation of 4 columns is achieved. It may be 4 consequent spaces,
336345
a single tab with width equal to 4, or two tabs with width equal to 2.
337346

338347
This is when ``indent_style`` comes into picture. It specifies what character should be used **whenever possible** in order to

0 commit comments

Comments
 (0)