Mercurial > emacs
comparison lisp/files.el @ 77697:7238f814c101
(mode-require-final-newline, require-final-newline, enable-local-variables,
enable-local-eval): Doc fixes.
author | Juanma Barranquero <lekktu@gmail.com> |
---|---|
date | Mon, 14 May 2007 10:28:06 +0000 |
parents | c1c0e593ebb4 |
children | 2f4cc000e4de d7172f202ab8 |
comparison
equal
deleted
inserted
replaced
77696:b43e6f8f3e6e | 77697:7238f814c101 |
---|---|
285 | 285 |
286 A value of t means do this only when the file is about to be saved. | 286 A value of t means do this only when the file is about to be saved. |
287 A value of `visit' means do this right after the file is visited. | 287 A value of `visit' means do this right after the file is visited. |
288 A value of `visit-save' means do it at both of those times. | 288 A value of `visit-save' means do it at both of those times. |
289 Any other non-nil value means ask user whether to add a newline, when saving. | 289 Any other non-nil value means ask user whether to add a newline, when saving. |
290 nil means don't add newlines. | 290 A value of nil means don't add newlines. |
291 | 291 |
292 Certain major modes set this locally to the value obtained | 292 Certain major modes set this locally to the value obtained |
293 from `mode-require-final-newline'." | 293 from `mode-require-final-newline'." |
294 :type '(choice (const :tag "When visiting" visit) | 294 :type '(choice (const :tag "When visiting" visit) |
295 (const :tag "When saving" t) | 295 (const :tag "When saving" t) |
307 A value of t means do this only when the file is about to be saved. | 307 A value of t means do this only when the file is about to be saved. |
308 A value of `visit' means do this right after the file is visited. | 308 A value of `visit' means do this right after the file is visited. |
309 A value of `visit-save' means do it at both of those times. | 309 A value of `visit-save' means do it at both of those times. |
310 Any other non-nil value means ask user whether to add a newline, when saving. | 310 Any other non-nil value means ask user whether to add a newline, when saving. |
311 | 311 |
312 nil means do not add newlines. That is a risky choice in this variable | 312 A value of nil means do not add newlines. That is a risky choice in this |
313 since this value is used for modes for files that ought to have final newlines. | 313 variable since this value is used for modes for files that ought to have |
314 So if you set this to nil, you must explicitly check and add | 314 final newlines. So if you set this to nil, you must explicitly check and |
315 a final newline, whenever you save a file that really needs one." | 315 add a final newline, whenever you save a file that really needs one." |
316 :type '(choice (const :tag "When visiting" visit) | 316 :type '(choice (const :tag "When visiting" visit) |
317 (const :tag "When saving" t) | 317 (const :tag "When saving" t) |
318 (const :tag "When visiting or saving" visit-save) | 318 (const :tag "When visiting or saving" visit-save) |
319 (const :tag "Don't add newlines" nil) | 319 (const :tag "Don't add newlines" nil) |
320 (other :tag "Ask each time" ask)) | 320 (other :tag "Ask each time" ask)) |
457 \(When you say yes to certain values, they are remembered as safe.) | 457 \(When you say yes to certain values, they are remembered as safe.) |
458 | 458 |
459 :safe means set the safe variables, and ignore the rest. | 459 :safe means set the safe variables, and ignore the rest. |
460 :all means set all variables, whether safe or not. | 460 :all means set all variables, whether safe or not. |
461 (Don't set it permanently to :all.) | 461 (Don't set it permanently to :all.) |
462 nil means always ignore the file local variables. | 462 A value of nil means always ignore the file local variables. |
463 | 463 |
464 Any other value means always query you once whether to set them all. | 464 Any other value means always query you once whether to set them all. |
465 \(When you say yes to certain values, they are remembered as safe, but | 465 \(When you say yes to certain values, they are remembered as safe, but |
466 this has no effect when `enable-local-variables' is \"something else\".) | 466 this has no effect when `enable-local-variables' is \"something else\".) |
467 | 467 |
489 | 489 |
490 (defcustom enable-local-eval 'maybe | 490 (defcustom enable-local-eval 'maybe |
491 "Control processing of the \"variable\" `eval' in a file's local variables. | 491 "Control processing of the \"variable\" `eval' in a file's local variables. |
492 The value can be t, nil or something else. | 492 The value can be t, nil or something else. |
493 A value of t means obey `eval' variables; | 493 A value of t means obey `eval' variables; |
494 nil means ignore them; anything else means query." | 494 A value of nil means ignore them; anything else means query." |
495 :type '(choice (const :tag "Obey" t) | 495 :type '(choice (const :tag "Obey" t) |
496 (const :tag "Ignore" nil) | 496 (const :tag "Ignore" nil) |
497 (other :tag "Query" other)) | 497 (other :tag "Query" other)) |
498 :group 'find-file) | 498 :group 'find-file) |
499 | 499 |