(Format Conversion Piecemeal): Clarify

`after-insert-file-functions' calling convention.

diff --git a/lispref/ChangeLog b/lispref/ChangeLog
index fac06d0f9c88d9d0d7c81bf39b5507fcb937b9b2..1e5e94258b12e69d1a9bc1b3663c19e36584bc95 100644 (file)
--- a/lispref/ChangeLog
+++ b/lispref/ChangeLog
@@ -1,3 +1,8 @@
+2007-06-27  Richard Stallman  <rms@gnu.org>
+
+       * files.texi (Format Conversion Piecemeal): Clarify
+       `after-insert-file-functions' calling convention.
+
 2007-06-27  Michael Albinus  <michael.albinus@gmx.de>
 
        * files.texi (Magic File Names): Remove `dired-call-process'.  Add

diff --git a/lispref/files.texi b/lispref/files.texi
index 730b2b9b49742c83bab8bb819cb23efb01c2b56b..659229681b9cf312b00ea94ccb7b50f4902fbc3c 100644 (file)
--- a/lispref/files.texi
+++ b/lispref/files.texi
@@ -3071,8 +3071,10 @@ have been dealt with by this function.
 
 @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