NAME

       editorconfig-format - EditorConfig File Format

EditorConfig File Format

       EditorConfig files use an INI format that is compatible with the format used by Python
       ConfigParser Library, but [ and ] are allowed in the section names. The section names are
       filepath globs, similar to the format accepted by gitignore. Forward slashes (/) are used
       as path separators and semicolons (;) or octothorpes (#) are used for comments. Comments
       should go individual lines. EditorConfig files should be UTF-8 encoded, with either CRLF
       or LF line separators.

       Filename globs containing path separators (/) match filepaths in the same way as the
       filename globs used by .gitignore files. Backslashes (\) are not allowed as path
       separators.

       A semicolon character (;) starts a line comment that terminates at the end of the line.
       Line comments and blank lines are ignored when parsing. Comments may be added to the ends
       of non-empty lines. An octothorpe character (#) may be used instead of a semicolon to
       denote the start of a comment.

Filename and Location

       When a filename is given to EditorConfig a search is performed in the directory of the
       given file and all parent directories for an EditorConfig file (named '.editorconfig' by
       default). All found EditorConfig files are searched for sections with section names
       matching the given filename. The search will stop if an EditorConfig file is found with
       the root property set to true or when reaching the root filesystem directory.

       Files are read top to bottom and the most recent rules found take precedence. If multiple
       EditorConfig files have matching sections, the rules from the closer EditorConfig file are
       read last, so properties in closer files take precedence.

Wildcard Patterns

       Section names in EditorConfig files are filename globs that support pattern matching
       through Unix shell-style wildcards. These filename globs recognize the following as
       special characters for wildcard matching:

       *            Matches any string of characters, except path separators (/)

       **           Matches any string of characters

       ?            Matches any single character

       [seq]        Matches any single character in seq

       [!seq]       Matches any single character not in seq

       {s1,s2,s3}   Matches any of the strings given (separated by commas, can be nested)

       {num1..num2} Matches any integer numbers between num1 and num2, where num1 and num2 can be
       either positive or negative

       The backslash character () can be used to escape a character so it is not interpreted as a
       special character.

       The maximum length of a section name is 4096 characters. All sections exceeding this limit
       are ignored.

Supported Properties

       EditorConfig file sections contain properties, which are name-value pairs separated by an
       equal sign (=). EditorConfig plugins will ignore unrecognized property names and
       properties with invalid values.

       Here is the list of all property names understood by EditorConfig and all valid values for
       these properties:

       • indent_style: set to 'tab' or 'space' to use hard tabs or soft tabs respectively. The
         values are case insensitive.
       • indent_size: a whole number defining the number of columns used for each indentation
         level and the width of soft tabs (when supported). If this equals to 'tab', the
         indent_size will be set to the tab size, which should be tab_width if tab_width is
         specified, or the tab size set by editor if tab_width is not specified. The values are
         case insensitive.
       • tab_width: a whole number defining the number of columns used to represent a tab
         character. This defaults to the value of indent_size and should not usually need to be
         specified.
       • end_of_line: set to 'lf', 'cr', or 'crlf' to control how line breaks are represented.
         The values are case insensitive.
       • charset: set to 'latin1', 'utf-8', 'utf-8-bom', 'utf-16be' or 'utf-16le' to control the
         character set. Use of 'utf-8-bom' is discouraged.
       • trim_trailing_whitespace: set to 'true' to remove any whitespace characters preceding
         newline characters and 'false' to ensure it doesn't.
       • insert_final_newline: set to 'true' ensure file ends with a newline when saving and
         'false' to ensure it doesn't.
       • root: special property that should be specified at the top of the file outside of any
         sections. Set to 'true' to stop .editorconfig files search on current file. The value is
         case insensitive.
       For any property, a value of 'unset' is to remove the effect of that property, even if it
       has been set before. For example, add 'indent_size = unset' to undefine indent_size
       property (and use editor default).
       Property names are case insensitive and all property names are lowercased when parsing.
       The maximum length of a property name is 50 characters and the maximum length of a
       property value is 255 characters. Any property beyond these limits would be ignored.