Variable: dir-locals-file

dir-locals-file is a variable defined in files.el.gz.

Value

".dir-locals.el"

Documentation

File that contains directory-local variables.

It has to be constant to enforce uniform values across different environments and users.

A second dir-locals file can be used by a user to specify their personal dir-local variables even if the current directory already has a dir-locals-file that is shared with other users (such as in a git repository). The name of this second file is derived by appending "-2" to the base name of dir-locals-file. With the default value of dir-locals-file, a ".dir-locals-2.el" file in the same directory will override the ".dir-locals.el".

See Info node (elisp)Directory Local Variables for details.

Probably introduced at or before Emacs version 26.1.

Source Code

;; Defined in /usr/src/emacs/lisp/files.el.gz
(defconst dir-locals-file ".dir-locals.el"
  "File that contains directory-local variables.
It has to be constant to enforce uniform values across different
environments and users.

A second dir-locals file can be used by a user to specify their
personal dir-local variables even if the current directory
already has a `dir-locals-file' that is shared with other
users (such as in a git repository).  The name of this second
file is derived by appending \"-2\" to the base name of
`dir-locals-file'.  With the default value of `dir-locals-file',
a \".dir-locals-2.el\" file in the same directory will override
the \".dir-locals.el\".

See Info node `(elisp)Directory Local Variables' for details.")