[Emacs-diffs] /srv/bzr/emacs/trunk r106886: files.el doc fixes.

[Glenn Morris]

------------------------------------------------------------
revno: 106886
committer: Glenn Morris <address@hidden>
branch nick: trunk
timestamp: Tue 2012-01-17 20:33:19 -0500
message:
  files.el doc fixes.
  
  * lisp/files.el (auto-mode-alist, inhibit-first-line-modes-regexps)
  (set-auto-mode): Doc fixes.
modified:
  lisp/ChangeLog
  lisp/files.el

=== modified file 'lisp/ChangeLog'
--- a/lisp/ChangeLog    2012-01-17 22:33:05 +0000
+++ b/lisp/ChangeLog    2012-01-18 01:33:19 +0000
@@ -1,3 +1,8 @@
+2012-01-18  Glenn Morris  <address@hidden>
+
+       * files.el (auto-mode-alist, inhibit-first-line-modes-regexps)
+       (set-auto-mode): Doc fixes.
+
 2012-01-17  Glenn Morris  <address@hidden>
 
        * isearch.el (search-nonincremental-instead): Fix doc typo.

=== modified file 'lisp/files.el'
--- a/lisp/files.el     2012-01-07 19:51:13 +0000
+++ b/lisp/files.el     2012-01-18 01:33:19 +0000
@@ -2405,9 +2405,6 @@
 calling FUNCTION (if it's not nil), we delete the suffix that matched
 REGEXP and search the list again for another match.
 
-If the file name matches `inhibit-first-line-modes-regexps',
-then `auto-mode-alist' is not processed.
-
 The extensions whose FUNCTION is `archive-mode' should also
 appear in `auto-coding-alist' with `no-conversion' coding system.
 
@@ -2481,7 +2478,8 @@
 (defvar inhibit-first-line-modes-regexps
   (mapcar 'purecopy '("\\.tar\\'" "\\.tgz\\'" "\\.tiff?\\'"
                      "\\.gif\\'" "\\.png\\'" "\\.jpe?g\\'"))
-  "List of regexps; if one matches a file name, don't look for `-*-'.")
+  "List of regexps; if one matches a file name, don't look for `-*-'.
+See also `inhibit-first-line-modes-suffixes'.")
 
 (defvar inhibit-first-line-modes-suffixes nil
   "List of regexps for what to ignore, for `inhibit-first-line-modes-regexps'.
@@ -2550,7 +2548,8 @@
 (defun set-auto-mode (&optional keep-mode-if-same)
   "Select major mode appropriate for current buffer.
 
-To find the right major mode, this function checks for a -*- mode tag,
+To find the right major mode, this function checks for a -*- mode tag
+\(unless `inhibit-first-line-modes-regexps' says not to),
 checks for a `mode:' entry in the Local Variables section of the file,
 checks if it uses an interpreter listed in `interpreter-mode-alist',
 matches the buffer beginning against `magic-mode-alist',