(auto-coding-functions): Doc fix.

1 files changed, 12 insertions, 8 deletions

diff --git a/lisp/international/mule.el b/lisp/international/mule.el
index 6fb078486d5..f37c3704cf2 100644
--- a/lisp/international/mule.el
+++ b/lisp/international/mule.el
@@ -1513,14 +1513,18 @@ and the contents of `file-coding-system-alist'."
 				   sgml-html-meta-auto-coding-function)
   "A list of functions which attempt to determine a coding system.
 
-Each function in this list should be written to operate on the current
-buffer, but should not modify it in any way.  It should take one
-argument SIZE, past which it should not search.  If a function
-succeeds in determining a coding system, it should return that coding
-system.  Otherwise, it should return nil.
-
-Any `coding:' tags present have a higher priority than the
-functions in this list."
+Each function in this list should be written to operate on the
+current buffer, but should not modify it in any way.  The buffer
+will contain undecoded text of parts of the file.  Each function
+should take one argument, SIZE, which says how many
+characters (starting from point) it should look at.
+
+If one of these functions succeeds in determining a coding
+system, it should return that coding system.  Otherwise, it
+should return nil.
+
+If a file has a `coding:' tag, that takes precedence over these
+functions, so they won't be called at all."
   :group 'files
   :group 'mule
   :type '(repeat function))