cc-mode / README

Diff from to
-README for CC Mode 5.28
+README for CC Mode 5.30
 Current maintainer : Martin Stjernholm
 Contact address    : bug-cc-mode@gnu.org
 
 
         <http://cc-mode.sourceforge.net/cc-mode.html>
 
-    As of this writing (February 25, 2001), CC Mode currently works
-    out of the box with XEmacs versions 19.15, 19.16, 20.3, 20.4,
-    21.0, 21.1, and 21.2, and with Emacs versions 19.34, 20.x, and
-    21.0.  (It very likely works with later versions too, when they
-    become available.)
+    As of this writing (June 10, 2003), CC Mode currently works out of
+    the box with XEmacs versions 19.15, 19.16, 20.3, 20.4, and 21.x,
+    and with Emacs versions 19.34, 20.x, and 21.x.  (It will very
+    likely work with later versions too, when they become available.)
 
 MORE INFORMATION
 
     Preformatted versions of the manual in DVI, PostScript, and Info,
     are all available at the CC Mode web page.
 
-    To build the manual yourself, you will need the latest Texinfo
-    release (as of this writing, Texinfo 4.0).  To build the Info
+    To build the manual yourself, you will need a recent Texinfo
+    release (as of this writing, it's known to work with Texinfo 4.3
+    but somewhat older releases might be ok too).  To build the Info
     manual, simply type:
 
         % makeinfo cc-mode.texi
 
         % texi2dvi cc-mode.texi
 
-    Note that I've heard of other package releases that purport to
-    include a texinfo.tex file newer than 2.185, but these don't
-    support the @macro{} command.  If you have problems building the
-    manuals, pick up a pre-built version.
-
 INSTALLATION
 
     Here is a quick guide for installing CC Mode.  For the latest
 
   Byte Compiling
 
-    It is highly recommended that you byte-compile CC Mode, for both
-    performance and compatibility reasons.  Running CC Mode
-    un-bytecompiled is not supported and may not work at all depending
-    on the flavor of (X)Emacs you are using.
+    It is highly recommended that you byte-compile CC Mode for
+    performance reasons.  Running CC Mode non-byte-compiled is not
+    supported.
 
     You can compile CC Mode in the same way as any other package.  To
     compile it from a running (X)Emacs session:
     To compile CC Mode from the shell:
 
         % cd /path/to/cc-mode
-        % $(EMACS) -batch -q -f batch-byte-compile cc-*.el
+        % $(EMACS) -batch -no-site-file -q -f batch-byte-compile cc-*.el
 
     where $(EMACS) is either emacs or xemacs depending on the flavor
     you use.
     Put the compiled files somewhere (X)Emacs will find them, i.e. in
     some path that's in the load-path variable.  You must make sure
     they are found before any CC Mode files which are distributed with
-    (X)Emacs.  A directory have higher precendence than all
-    directories after it in the load-path list.
+    (X)Emacs.  A directory has higher precendence than all directories
+    after it in the load-path list.
+
+    If you're going to be using AWK Mode, insert the following line
+    into your .emacs or init.el file:
+
+        (autoload 'awk-mode "cc-mode" nil t)
+
+    This will cause (X)Emacs to use the new AWK Mode for AWK files,
+    rather than the older mode contained in the file awk-mode.elc.
+    (But see the note below under "Compatibility Issues".)
 
     To test that you have things set up correctly, visit a C file and
     then type:
     there.  You need to get a later Custom library and make sure it's
     loaded when CC Mode is compiled to enable it.
 
+    The new AWK Mode requires a feature (syntax-table text properties)
+    which first appeared in Emacs 20.1 and XEmacs 21.4.  If you are
+    still using an older version of (X)Emacs, CC Mode will revert to
+    using the older AWK Mode which is distributed with (X)Emacs (from
+    file awk-mode.elc) for AWK files, even when the autoload form (see
+    above) appears in your .emacs or init.el file.  Upgrading your
+    (X)Emacs is strongly recommended if this is the case.  You can
+    check which AWK Mode you are running by displaying the mode
+    documentation string with C-h m from an AWK buffer.  The newer
+    mode's doc string contains "to submit a problem report, enter `C-c
+    C-b'" near the top of the doc string where the older mode has
+    "This is much like C mode except ....".
+
     For more details about interactions with different packages, see
     the CC Mode web page.
Tip: Filter by directory path e.g. /media app.js to search for public/media/app.js.
Tip: Use camelCasing e.g. ProjME to search for ProjectModifiedEvent.java.
Tip: Filter by extension type e.g. /repo .js to search for all .js files in the /repo directory.
Tip: Separate your search with spaces e.g. /ssh pom.xml to search for src/ssh/pom.xml.
Tip: Use ↑ and ↓ arrow keys to navigate and return to view the file.
Tip: You can also navigate files with Ctrl+j (next) and Ctrl+k (previous) and view the file with Ctrl+o.
Tip: You can also navigate files with Alt+j (next) and Alt+k (previous) and view the file with Alt+o.