procyberian/emacs
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Improve documentation of 'inhibit-modification-hooks' and friends

Browse source 
* src/buffer.c (Fset_buffer_modified_p)
(Frestore_buffer_modified_p): Doc fixes.
* src/insdel.c (syms_of_insdel) <inhibit-modification-hooks>:
Document in the doc string that this variable also inhibits file
locks and active region handling.  (Bug#29846)
This commit is contained in:
Eli Zaretskii 2017-12-28 19:23:34 +02:00
parent 7175496d7a
commit 81b1028b63
2 changed files with 14 additions and 3 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

12
src/buffer.c
View file

@ -1320,7 +1320,12 @@ menu bar menus and the frame title. */)
DEFUN ("set-buffer-modified-p", Fset_buffer_modified_p, Sset_buffer_modified_p, DEFUN ("set-buffer-modified-p", Fset_buffer_modified_p, Sset_buffer_modified_p,
1, 1, 0, 1, 1, 0,
doc: /* Mark current buffer as modified or unmodified according to FLAG. doc: /* Mark current buffer as modified or unmodified according to FLAG.
A non-nil FLAG means mark the buffer modified. */) A non-nil FLAG means mark the buffer modified.
In addition, this function unconditionally forces redisplay of the
mode lines of the windows that display the current buffer, and also
locks or unlocks the file visited by the buffer, depending on whether
the function's argument is non-nil, but only if both `buffer-file-name'
and `buffer-file-truename' are non-nil. */)
(Lisp_Object flag) (Lisp_Object flag)
{ {
Frestore_buffer_modified_p (flag); Frestore_buffer_modified_p (flag);
@ -1341,7 +1346,10 @@ A non-nil FLAG means mark the buffer modified. */)
DEFUN ("restore-buffer-modified-p", Frestore_buffer_modified_p, DEFUN ("restore-buffer-modified-p", Frestore_buffer_modified_p,
Srestore_buffer_modified_p, 1, 1, 0, Srestore_buffer_modified_p, 1, 1, 0,
doc: /* Like `set-buffer-modified-p', with a difference concerning redisplay. doc: /* Like `set-buffer-modified-p', but doesn't redisplay buffer's mode line.
This function also locks and unlocks the file visited by the buffer,
if both `buffer-file-truename' and `buffer-file-name' are non-nil.
It is not ensured that mode lines will be updated to show the modified It is not ensured that mode lines will be updated to show the modified
state of the current buffer. Use with care. */) state of the current buffer. Use with care. */)
(Lisp_Object flag) (Lisp_Object flag)

5
src/insdel.c
View file

@ -2342,7 +2342,10 @@ syms_of_insdel (void)
DEFVAR_BOOL ("inhibit-modification-hooks", inhibit_modification_hooks, DEFVAR_BOOL ("inhibit-modification-hooks", inhibit_modification_hooks,
doc: /* Non-nil means don't run any of the hooks that respond to buffer changes. doc: /* Non-nil means don't run any of the hooks that respond to buffer changes.
This affects `before-change-functions' and `after-change-functions', This affects `before-change-functions' and `after-change-functions',
as well as hooks attached to text properties and overlays. */); as well as hooks attached to text properties and overlays.
Setting this variable non-nil also inhibits file locks and checks
whether files are locked by another Emacs session, as well as
handling of the active region per `select-active-regions'. */);
inhibit_modification_hooks = 0; inhibit_modification_hooks = 0;
DEFSYM (Qinhibit_modification_hooks, "inhibit-modification-hooks"); DEFSYM (Qinhibit_modification_hooks, "inhibit-modification-hooks");