(append-to-file): Doc fix.

diff --git a/lisp/ChangeLog b/lisp/ChangeLog
index 33b315367ba8bf7f7461ad9af43275b1e17b9b0a..8eb266495d64103ca2f1a7f7312b939eba7a7583 100644 (file)
--- a/lisp/ChangeLog
+++ b/lisp/ChangeLog
@@ -1,5 +1,7 @@
 2009-04-08  Eli Zaretskii  <eliz@gnu.org>
 
+       * files.el (append-to-file): Doc fix.
+
        * term/pc-win.el (msdos-last-help-message): New defvar.
        (msdos-show-help): Use it to avoid saving the last message if it
        was also a help message (Bug#2895).

diff --git a/lisp/files.el b/lisp/files.el
index 7c792c96c52a9a1c408b8fc263b383e9f97793c2..499948c4176ee82930c7447e643bbe2b5cd38b3a 100644 (file)
--- a/lisp/files.el
+++ b/lisp/files.el
@@ -4475,8 +4475,14 @@ Don't call it from programs!  Use `insert-file-contents' instead.
 (defun append-to-file (start end filename)
   "Append the contents of the region to the end of file FILENAME.
 When called from a function, expects three arguments,
-START, END and FILENAME.  START and END are buffer positions
-saying what text to write."
+START, END and FILENAME.  START and END are normally buffer positions
+specifying the part of the buffer to write.
+If START is nil, that means to use the entire buffer contents.
+If START is a string, then output that string to the file
+instead of any buffer contents; END is ignored.
+
+This does character code conversion and applies annotations
+like `write-region' does."
   (interactive "r\nFAppend to file: ")
   (write-region start end filename t))