Commit e1b867a0 authored by Juri Linkov's avatar Juri Linkov
Browse files

(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'.
parent fc0318c6
2008-11-22 Juri Linkov <juri@jurta.org>
* custom.texi (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'.
2008-11-22 Lute Kamstra <lute@gnu.org> 2008-11-22 Lute Kamstra <lute@gnu.org>
* buffers.texi (Select Buffer): Index goto-line. * buffers.texi (Select Buffer): Index goto-line.
......
...@@ -1269,10 +1269,10 @@ variable. ...@@ -1269,10 +1269,10 @@ variable.
This can be done one of two ways. This can be done one of two ways.
The first approach is to put a special file, named The first approach is to put a special file, named
@file{.dir-settings.el}, in a directory. When opening a file, Emacs @file{.dir-locals.el}, in a directory. When opening a file, Emacs
searches for @file{.dir-settings.el} starting in the file's directory searches for @file{.dir-locals.el} starting in the file's directory
and then moving up the directory hierarchy. If 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 the file to the new buffer. If the file is remote, Emacs skips this
search, because it would be too slow. search, because it would be too slow.
...@@ -1300,20 +1300,21 @@ to @samp{BSD}. Finally, it specifies a different @file{ChangeLog} ...@@ -1300,20 +1300,21 @@ to @samp{BSD}. Finally, it specifies a different @file{ChangeLog}
file name for any file in the project that appears beneath the file name for any file in the project that appears beneath the
directory @file{src/imported}. directory @file{src/imported}.
The second approach to directory-local settings is to explicitly The second approach to directory-local variables is to explicitly
define a project class using @code{define-project-bindings}, and then define a project class using @code{dir-locals-set-class-variables}, and then
to tell Emacs which directory roots correspond to that class, using 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 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 example, you could apply settings to an unwriteable directory this
way: way:
@example @example
(define-project-bindings 'unwriteable-directory (dir-locals-set-class-variables 'unwriteable-directory
'((nil . ((some-useful-setting . value))))) '((nil . ((some-useful-setting . value)))))
(set-directory-project "/usr/include/" 'unwriteable-directory) (dir-locals-set-directory-class
"/usr/include/" 'unwriteable-directory)
@end example @end example
Unsafe directory-local variables are handled in the same way as Unsafe directory-local variables are handled in the same way as
......
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment