From e1b867a0bc762a356697bdf69df5106dc3759d26 Mon Sep 17 00:00:00 2001 From: Juri Linkov Date: Sat, 22 Nov 2008 19:08:03 +0000 Subject: [PATCH] (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'. --- doc/emacs/ChangeLog | 7 +++++++ doc/emacs/custom.texi | 19 ++++++++++--------- 2 files changed, 17 insertions(+), 9 deletions(-) diff --git a/doc/emacs/ChangeLog b/doc/emacs/ChangeLog index aae09731c5d..9e2cf1871fe 100644 --- a/doc/emacs/ChangeLog +++ b/doc/emacs/ChangeLog @@ -1,3 +1,10 @@ +2008-11-22 Juri Linkov + + * 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 * buffers.texi (Select Buffer): Index goto-line. diff --git a/doc/emacs/custom.texi b/doc/emacs/custom.texi index 57f656eb1fe..a00abe0457c 100644 --- a/doc/emacs/custom.texi +++ b/doc/emacs/custom.texi @@ -1269,10 +1269,10 @@ variable. 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 @@ to @samp{BSD}. Finally, it specifies a different @file{ChangeLog} 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 -- 2.39.2