# HG changeset patch # User Juri Linkov # Date 1227380864 0 # Node ID 3152ddc2deb7dd3788c13783879797d8c11f28bd # Parent f37d12337b26a83e3bea33d9f3fe6bc9748ff63d (Directory Variables): Rename ".dir-settings.el" to ".dir-locals.el". Rename `define-project-bindings' to `dir-locals-set-class-variables'. Rename `set-directory-project' to `dir-locals-set-directory-class'. diff -r f37d12337b26 -r 3152ddc2deb7 doc/emacs/custom.texi --- a/doc/emacs/custom.texi Sat Nov 22 19:06:02 2008 +0000 +++ b/doc/emacs/custom.texi Sat Nov 22 19:07:44 2008 +0000 @@ -1269,10 +1269,10 @@ This can be done one of two ways. The first approach is to put a special file, named -@file{.dir-settings.el}, in a directory. When opening a file, Emacs -searches for @file{.dir-settings.el} starting in the file's directory +@file{.dir-locals.el}, in a directory. When opening a file, Emacs +searches for @file{.dir-locals.el} starting in the file's directory and then moving up the directory hierarchy. If -@file{.dir-settings.el} is found, Emacs applies variable settings from +@file{.dir-locals.el} is found, Emacs applies variable settings from the file to the new buffer. If the file is remote, Emacs skips this search, because it would be too slow. @@ -1300,20 +1300,21 @@ file name for any file in the project that appears beneath the directory @file{src/imported}. - The second approach to directory-local settings is to explicitly -define a project class using @code{define-project-bindings}, and then + The second approach to directory-local variables is to explicitly +define a project class using @code{dir-locals-set-class-variables}, and then to tell Emacs which directory roots correspond to that class, using -@code{set-directory-project}. You can put calls to these functions in +@code{dir-locals-set-directory-class}. You can put calls to these functions in your @file{.emacs}; this can be useful when you can't put -@file{.dir-settings.el} in the directory for some reason. For +@file{.dir-locals.el} in the directory for some reason. For example, you could apply settings to an unwriteable directory this way: @example -(define-project-bindings 'unwriteable-directory +(dir-locals-set-class-variables 'unwriteable-directory '((nil . ((some-useful-setting . value))))) -(set-directory-project "/usr/include/" 'unwriteable-directory) +(dir-locals-set-directory-class + "/usr/include/" 'unwriteable-directory) @end example Unsafe directory-local variables are handled in the same way as