Skip to content

Commit d3f1cf6

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

File tree

1 file changed

+9
-1
lines changed

1 file changed

+9
-1
lines changed

index.rst

Lines changed: 9 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -60,6 +60,14 @@ 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 assumed to be interchangable and to represent the
64+
character defined by the Unicode HT/TAB symbol (U+0009).
65+
- The words "space" and "soft tab" are also assumed to be interchangable and to represent the
66+
character defined by the Unicode Space/SP symbol (U+0020).
67+
- "Column" is an abstract atomic unit of indentation. A single space, as defined above,
68+
is expected to contribute exactly one column to the indentation of a given line. The amount of
69+
columns contributed by the hard tab depends on the configuration pairs defined in the
70+
:ref:`_supported-pairs` section.
6371

6472
A conforming core or plugin must pass the tests in the
6573
`core-tests repository`_ or `plugin-tests repository`_, respectively.
@@ -332,7 +340,7 @@ section to specify their behavior. Consider the following code snippet:
332340
333341
The ``indent_size`` setting for this code snippet equals 4, because ``indent_size`` means how many columns are required
334342
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,
343+
is *how* this indentation of 4 columns is achieved. It may be 4 consequent spaces,
336344
a single tab with width equal to 4, or two tabs with width equal to 2.
337345

338346
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)