comparison src/buffer.c @ 110838:63399fcc7ef2

Doc fix. * src/buffer.c (before-change-functions, after-change-functions): Three-year overdue doc fix following 2007-08-13 change.
author Glenn Morris <rgm@gnu.org>
date Sat, 02 Oct 2010 18:23:50 -0700
parents fc5ebbbba4f3
children bec49af30c2f 376148b31b5e
comparison
equal deleted inserted replaced
110837:d35b3cc77cf3 110838:63399fcc7ef2
6094 \(For an insertion, the beginning and end are at the same place.) 6094 \(For an insertion, the beginning and end are at the same place.)
6095 No information is given about the length of the text after the change. 6095 No information is given about the length of the text after the change.
6096 6096
6097 Buffer changes made while executing the `before-change-functions' 6097 Buffer changes made while executing the `before-change-functions'
6098 don't call any before-change or after-change functions. 6098 don't call any before-change or after-change functions.
6099 That's because these variables are temporarily set to nil. 6099 That's because `inhibit-modification-hooks' is temporarily set non-nil.
6100 As a result, a hook function cannot straightforwardly alter the
6101 value of these variables. See the Emacs Lisp manual for a way of
6102 accomplishing an equivalent result by using other variables.
6103 6100
6104 If an unhandled error happens in running these functions, 6101 If an unhandled error happens in running these functions,
6105 the variable's value remains nil. That prevents the error 6102 the variable's value remains nil. That prevents the error
6106 from happening repeatedly and making Emacs nonfunctional. */); 6103 from happening repeatedly and making Emacs nonfunctional. */);
6107 Vbefore_change_functions = Qnil; 6104 Vbefore_change_functions = Qnil;
6115 for a deletion, that length is the number of bytes deleted, 6112 for a deletion, that length is the number of bytes deleted,
6116 and the post-change beginning and end are at the same place.) 6113 and the post-change beginning and end are at the same place.)
6117 6114
6118 Buffer changes made while executing the `after-change-functions' 6115 Buffer changes made while executing the `after-change-functions'
6119 don't call any before-change or after-change functions. 6116 don't call any before-change or after-change functions.
6120 That's because these variables are temporarily set to nil. 6117 That's because `inhibit-modification-hooks' is temporarily set non-nil.
6121 As a result, a hook function cannot straightforwardly alter the
6122 value of these variables. See the Emacs Lisp manual for a way of
6123 accomplishing an equivalent result by using other variables.
6124 6118
6125 If an unhandled error happens in running these functions, 6119 If an unhandled error happens in running these functions,
6126 the variable's value remains nil. That prevents the error 6120 the variable's value remains nil. That prevents the error
6127 from happening repeatedly and making Emacs nonfunctional. */); 6121 from happening repeatedly and making Emacs nonfunctional. */);
6128 Vafter_change_functions = Qnil; 6122 Vafter_change_functions = Qnil;