# HG changeset patch
# User Richard M. Stallman <rms@gnu.org>
# Date 1182986948 0
# Node ID 1027d988ef4c46381258ff4c56a0b5b4d77a36f4
# Parent  8e5203081e80380d1b5c49d1d52d79192f65ec0a
(Format Conversion Piecemeal): Clarify
`after-insert-file-functions' calling convention.

diff -r 8e5203081e80 -r 1027d988ef4c lispref/files.texi
--- 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