(format-alist): Doc fix.
authorGlenn Morris <rgm@gnu.org>
Tue, 25 Aug 2009 03:03:27 +0000 (03:03 +0000)
committerGlenn Morris <rgm@gnu.org>
Tue, 25 Aug 2009 03:03:27 +0000 (03:03 +0000)
lisp/ChangeLog
lisp/format.el

index 231b1d9..55949d4 100644 (file)
@@ -1,3 +1,7 @@
+2009-08-25  Glenn Morris  <rgm@gnu.org>
+
+       * format.el (format-alist): Doc fix.
+
 2009-08-24  Dmitry Dzhus  <dima@sphinx.net.ru>
 
        * progmodes/gdb-mi.el (gdb-mapcar*): Replacement for `mapcar*'
index 27253a2..3add7ba 100644 (file)
@@ -1,7 +1,7 @@
 ;;; format.el --- read and save files in multiple formats
 
-;; Copyright (C) 1994, 1995, 1997, 1999, 2001, 2002, 2003, 2004,
-;;   2005, 2006, 2007, 2008, 2009 Free Software Foundation, Inc.
+;; Copyright (C) 1994, 1995, 1997, 1999, 2001, 2002, 2003, 2004, 2005,
+;;   2006, 2007, 2008, 2009  Free Software Foundation, Inc.
 
 ;; Author: Boris Goldowsky <boris@gnu.org>
 
@@ -106,9 +106,9 @@ DOC-STR should be a single line providing more information about the
         the user if they ask for more information.
 
 REGEXP  is a regular expression to match against the beginning of the file;
-        it should match only files in that format.  Use nil to avoid
-        matching at all for formats for which it isn't appropriate to
-        require explicit encoding/decoding.
+        it should match only files in that format.  REGEXP may be nil, in
+        which case the format will never be applied automatically to a file.
+        Use this for formats that you only ever want to apply manually.
 
 FROM-FN is called to decode files in that format; it takes two args, BEGIN
         and END, and can make any modifications it likes, returning the new
@@ -136,6 +136,7 @@ MODE-FN, if specified, is called when visiting a file with that format.
 
 PRESERVE, if non-nil, means that `format-write-file' should not remove
           this format from `buffer-file-format'.")
+;;;###autoload(put 'format-alist 'risky-local-variable t)
 
 ;;; Basic Functions (called from Lisp)