[Emacs-diffs] emacs/doc/misc cc-mode.texi

[Alan Mackenzie]

CVSROOT:        /cvsroot/emacs
Module name:    emacs
Changes by:     Alan Mackenzie <acmacm> 09/07/24 12:14:02

Modified files:
        doc/misc       : cc-mode.texi 

Log message:
        (Config Basics, File Styles): Document that at mode initialization, any
        individual variable setting now takes precedence over one done via
        c-file-style/c-file-offsets.

CVSWeb URLs:
http://cvs.savannah.gnu.org/viewcvs/emacs/doc/misc/cc-mode.texi?cvsroot=emacs&r1=1.13&r2=1.14

Patches:
Index: cc-mode.texi
===================================================================
RCS file: /cvsroot/emacs/emacs/doc/misc/cc-mode.texi,v
retrieving revision 1.13
retrieving revision 1.14
diff -u -b -r1.13 -r1.14
--- cc-mode.texi        16 Feb 2009 17:41:59 -0000      1.13
+++ cc-mode.texi        24 Jul 2009 12:14:02 -0000      1.14
@@ -2186,9 +2186,10 @@
 @item
 @table @asis
 @item Style
address@hidden File address@hidden earlier versions of @ccmode{}, a File Style 
setting took precedence over any other setting apart from a File Local Variable 
setting.}
 @itemx Top-level command or ``customization interface''
 @itemx Hook
address@hidden File Style
address@hidden File Local Variable setting
 @end table
 @end itemize
 
@@ -2275,11 +2276,18 @@
 See @ref{Styles} for fuller details on using @ccmode{} styles and how
 to create them.
 
address@hidden File Local Variable setting
+A @dfn{file local variable setting} is a setting which applies to an
+individual source file.  You put this in a @dfn{local variables list},
+a special block at the end of the source file (@pxref{Specifying File
+Variables,,, @emacsman{}}).
+
 @item File Styles
 A @dfn{file style} is a rarely used variant of the ``style'' mechanism
-described above, which applies to an individual source file.  To use
-it, you set certain Emacs local variables in a special block at the
-end of the source file.  @xref{File Styles}.
+described above, which applies to an individual source file.
address@hidden Styles}.  You use this by setting certain special variables
+in a local variables list (@pxref{Specifying File Variables,,,
address@hidden).
 
 @item Hooks with Styles
 For ultimate flexibility, you can use hooks and styles together.  For
@@ -2782,13 +2790,11 @@
 variable is virtually always address@hidden anyhow, you're unlikely to
 notice this effect.}.
 
-If you set any variables, including style variables, by the file local
-variables mechanism, these settings take priority over all other
-settings, even those in your mode hooks (@pxref{CC Hooks}).  If you
-use @code{c-file-style} or @code{c-file-offsets} and also explicitly
-set a style variable in a local variable block, the explicit setting
-will take priority.
-
+If you set any variable by the file local variables mechanism, that
+setting takes priority over all other settings, even those in your
+mode hooks (@pxref{CC Hooks}).  Any individual setting of a variable
+will override one made through @code{c-file-style} or
address@hidden
 @comment !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
 @node    Custom Filling and Breaking, Custom Auto-newlines, Config Basics, Top
 @comment node-name, next, previous, up