aboutsummaryrefslogtreecommitdiffstats
path: root/doc
diff options
context:
space:
mode:
authorJuri Linkov2008-11-22 19:08:03 +0000
committerJuri Linkov2008-11-22 19:08:03 +0000
commite1b867a0bc762a356697bdf69df5106dc3759d26 (patch)
tree00fd5cd09f0cdfcd1571b3e59e21dd85d228db96 /doc
parentfc0318c6d5b512023cc3c32551aaee624a2fd75e (diff)
downloademacs-e1b867a0bc762a356697bdf69df5106dc3759d26.tar.gz
emacs-e1b867a0bc762a356697bdf69df5106dc3759d26.zip
(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'.
Diffstat (limited to 'doc')
-rw-r--r--doc/emacs/ChangeLog7
-rw-r--r--doc/emacs/custom.texi19
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 @@
12008-11-22 Juri Linkov <juri@jurta.org>
2
3 * custom.texi (Directory Variables): Rename ".dir-settings.el" to
4 ".dir-locals.el". Rename `define-project-bindings' to
5 `dir-locals-set-class-variables'. Rename `set-directory-project' to
6 `dir-locals-set-directory-class'.
7
12008-11-22 Lute Kamstra <lute@gnu.org> 82008-11-22 Lute Kamstra <lute@gnu.org>
2 9
3 * buffers.texi (Select Buffer): Index goto-line. 10 * 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.
1269This can be done one of two ways. 1269This can be done one of two ways.
1270 1270
1271 The first approach is to put a special file, named 1271 The first approach is to put a special file, named
1272@file{.dir-settings.el}, in a directory. When opening a file, Emacs 1272@file{.dir-locals.el}, in a directory. When opening a file, Emacs
1273searches for @file{.dir-settings.el} starting in the file's directory 1273searches for @file{.dir-locals.el} starting in the file's directory
1274and then moving up the directory hierarchy. If 1274and then moving up the directory hierarchy. If
1275@file{.dir-settings.el} is found, Emacs applies variable settings from 1275@file{.dir-locals.el} is found, Emacs applies variable settings from
1276the file to the new buffer. If the file is remote, Emacs skips this 1276the file to the new buffer. If the file is remote, Emacs skips this
1277search, because it would be too slow. 1277search, because it would be too slow.
1278 1278
@@ -1300,20 +1300,21 @@ to @samp{BSD}. Finally, it specifies a different @file{ChangeLog}
1300file name for any file in the project that appears beneath the 1300file name for any file in the project that appears beneath the
1301directory @file{src/imported}. 1301directory @file{src/imported}.
1302 1302
1303 The second approach to directory-local settings is to explicitly 1303 The second approach to directory-local variables is to explicitly
1304define a project class using @code{define-project-bindings}, and then 1304define a project class using @code{dir-locals-set-class-variables}, and then
1305to tell Emacs which directory roots correspond to that class, using 1305to tell Emacs which directory roots correspond to that class, using
1306@code{set-directory-project}. You can put calls to these functions in 1306@code{dir-locals-set-directory-class}. You can put calls to these functions in
1307your @file{.emacs}; this can be useful when you can't put 1307your @file{.emacs}; this can be useful when you can't put
1308@file{.dir-settings.el} in the directory for some reason. For 1308@file{.dir-locals.el} in the directory for some reason. For
1309example, you could apply settings to an unwriteable directory this 1309example, you could apply settings to an unwriteable directory this
1310way: 1310way:
1311 1311
1312@example 1312@example
1313(define-project-bindings 'unwriteable-directory 1313(dir-locals-set-class-variables 'unwriteable-directory
1314 '((nil . ((some-useful-setting . value))))) 1314 '((nil . ((some-useful-setting . value)))))
1315 1315
1316(set-directory-project "/usr/include/" 'unwriteable-directory) 1316(dir-locals-set-directory-class
1317 "/usr/include/" 'unwriteable-directory)
1317@end example 1318@end example
1318 1319
1319 Unsafe directory-local variables are handled in the same way as 1320 Unsafe directory-local variables are handled in the same way as