(Format Conversion Piecemeal): Clarify

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

2 files changed, 9 insertions, 2 deletions

diff --git a/lispref/ChangeLog b/lispref/ChangeLog
index fac06d0f9c8..1e5e94258b1 100644
--- 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 730b2b9b497..659229681b9 100644
--- 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