diff options
| author | Juri Linkov | 2008-11-22 19:08:03 +0000 |
|---|---|---|
| committer | Juri Linkov | 2008-11-22 19:08:03 +0000 |
| commit | e1b867a0bc762a356697bdf69df5106dc3759d26 (patch) | |
| tree | 00fd5cd09f0cdfcd1571b3e59e21dd85d228db96 /doc | |
| parent | fc0318c6d5b512023cc3c32551aaee624a2fd75e (diff) | |
| download | emacs-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/ChangeLog | 7 | ||||
| -rw-r--r-- | 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 @@ | |||
| 1 | 2008-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 | |||
| 1 | 2008-11-22 Lute Kamstra <lute@gnu.org> | 8 | 2008-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. | |||
| 1269 | This can be done one of two ways. | 1269 | This 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 |
| 1273 | searches for @file{.dir-settings.el} starting in the file's directory | 1273 | searches for @file{.dir-locals.el} starting in the file's directory |
| 1274 | and then moving up the directory hierarchy. If | 1274 | and 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 |
| 1276 | the file to the new buffer. If the file is remote, Emacs skips this | 1276 | the file to the new buffer. If the file is remote, Emacs skips this |
| 1277 | search, because it would be too slow. | 1277 | search, because it would be too slow. |
| 1278 | 1278 | ||
| @@ -1300,20 +1300,21 @@ to @samp{BSD}. Finally, it specifies a different @file{ChangeLog} | |||
| 1300 | file name for any file in the project that appears beneath the | 1300 | file name for any file in the project that appears beneath the |
| 1301 | directory @file{src/imported}. | 1301 | directory @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 |
| 1304 | define a project class using @code{define-project-bindings}, and then | 1304 | define a project class using @code{dir-locals-set-class-variables}, and then |
| 1305 | to tell Emacs which directory roots correspond to that class, using | 1305 | to 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 |
| 1307 | your @file{.emacs}; this can be useful when you can't put | 1307 | your @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 |
| 1309 | example, you could apply settings to an unwriteable directory this | 1309 | example, you could apply settings to an unwriteable directory this |
| 1310 | way: | 1310 | way: |
| 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 |