changeset 81640:1027d988ef4c

(Format Conversion Piecemeal): Clarify `after-insert-file-functions' calling convention.
author Richard M. Stallman <rms@gnu.org>
date Wed, 27 Jun 2007 23:29:08 +0000
parents 8e5203081e80
children aa480bd84161
files lispref/files.texi
diffstat 1 files changed, 4 insertions(+), 2 deletions(-) [+]
line wrap: on
line diff
--- a/lispref/files.texi	Wed Jun 27 21:11:04 2007 +0000
+++ b/lispref/files.texi	Wed Jun 27 23:29:08 2007 +0000
@@ -3071,8 +3071,10 @@
 
 @defvar after-insert-file-functions
 Each function in this list is called by @code{insert-file-contents}
-with one argument, the number of characters inserted, and should
-return the new character count, leaving point the same.
+with one argument, the number of characters inserted, and with point
+at the beginning of the inserted text.  Each function should leave
+point unchanged, and return the new character count describing the
+inserted text as modified by the function.
 @c ??? The docstring mentions a handler from `file-name-handler-alist'
 @c     "intercepting" `insert-file-contents'.  Hmmm.  --ttn
 @end defvar