aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorRichard M. Stallman2004-05-29 15:46:57 +0000
committerRichard M. Stallman2004-05-29 15:46:57 +0000
commitc3a2e2d5ad1ab49369e89d1989e3396920a7bf15 (patch)
treeeddc245a2a4e389d71983e5c70b32ce6228bfbef
parent4d3867280ea96cd6252ea3f8e21d038a298f8d7e (diff)
downloademacs-c3a2e2d5ad1ab49369e89d1989e3396920a7bf15.tar.gz
emacs-c3a2e2d5ad1ab49369e89d1989e3396920a7bf15.zip
Put commas after i.e. and e.g. Minor cleanups.
-rw-r--r--man/cc-mode.texi126
1 files changed, 63 insertions, 63 deletions
diff --git a/man/cc-mode.texi b/man/cc-mode.texi
index 0f1e65051d8..c3b7dd4833f 100644
--- a/man/cc-mode.texi
+++ b/man/cc-mode.texi
@@ -354,7 +354,7 @@ Syntactic analysis for indentation is done when this is non-@code{nil}
354indented to the same level as the previous one, and @kbd{TAB} 354indented to the same level as the previous one, and @kbd{TAB}
355(@code{c-indent-command}) adjusts the indentation in steps of 355(@code{c-indent-command}) adjusts the indentation in steps of
356@code{c-basic-offset}. The indentation style has no effect, nor any of 356@code{c-basic-offset}. The indentation style has no effect, nor any of
357the indentation associated variables, e.g. @code{c-special-indent-hook}. 357the indentation associated variables, e.g., @code{c-special-indent-hook}.
358@end defopt 358@end defopt
359 359
360@menu 360@menu
@@ -381,7 +381,7 @@ elements (in lisp parlance, a @emph{cons cell}), the first being
381a @dfn{syntactic symbol}, the second being a @dfn{relative 381a @dfn{syntactic symbol}, the second being a @dfn{relative
382buffer position}. Syntactic symbols describe elements of C code 382buffer position}. Syntactic symbols describe elements of C code
383@footnote{Unless otherwise noted, the term ``C code'' refers to all 383@footnote{Unless otherwise noted, the term ``C code'' refers to all
384the C-like languages.}, e.g. @code{statement}, @code{substatement}, 384the C-like languages.}, e.g., @code{statement}, @code{substatement},
385@code{class-open}, @code{class-close}, etc. @xref{Syntactic Symbols}, 385@code{class-open}, @code{class-close}, etc. @xref{Syntactic Symbols},
386for a complete list of currently recognized syntactic symbols and their 386for a complete list of currently recognized syntactic symbols and their
387semantics. The style variable @code{c-offsets-alist} also contains the 387semantics. The style variable @code{c-offsets-alist} also contains the
@@ -411,7 +411,7 @@ We can use the command @kbd{C-c C-s} (bound to
411@code{c-show-syntactic-information}) to simply report what the 411@code{c-show-syntactic-information}) to simply report what the
412syntactic analysis is for the current line. Running this command on 412syntactic analysis is for the current line. Running this command on
413line 4 of this example, we'd see in the echo area@footnote{With a 413line 4 of this example, we'd see in the echo area@footnote{With a
414universal argument (i.e. @kbd{C-u C-c C-s}) the analysis is inserted 414universal argument (i.e., @kbd{C-u C-c C-s}) the analysis is inserted
415into the buffer as a comment on the current line.}: 415into the buffer as a comment on the current line.}:
416 416
417@example 417@example
@@ -677,7 +677,7 @@ definition. These constructs are also known as @dfn{syntactic
677whitespace} since they are usually ignored when scanning C code.}. 677whitespace} since they are usually ignored when scanning C code.}.
678 678
679@item 679@item
680No numeric argument was supplied to the command (i.e. it was typed as 680No numeric argument was supplied to the command (i.e., it was typed as
681normal, with no @kbd{C-u} prefix). 681normal, with no @kbd{C-u} prefix).
682@end itemize 682@end itemize
683 683
@@ -702,7 +702,7 @@ normal, with no @kbd{C-u} prefix).
702@kindex @{ 702@kindex @{
703@kindex @} 703@kindex @}
704 704
705When you type either an open or close brace (i.e. @kbd{@{} or @kbd{@}}), 705When you type either an open or close brace (i.e., @kbd{@{} or @kbd{@}}),
706the electric command @code{c-electric-brace} gets run. This command has 706the electric command @code{c-electric-brace} gets run. This command has
707two electric formatting behaviors. First, it will perform some 707two electric formatting behaviors. First, it will perform some
708reindentation of the line the brace was typed on, and second, it will 708reindentation of the line the brace was typed on, and second, it will
@@ -973,7 +973,7 @@ modes except IDL mode, since CORBA IDL doesn't have any statements.
973@dfn{Clean-ups} are mechanisms complementary to colon and brace hanging. 973@dfn{Clean-ups} are mechanisms complementary to colon and brace hanging.
974On the surface, it would seem that clean-ups overlap the functionality 974On the surface, it would seem that clean-ups overlap the functionality
975provided by the @code{c-hanging-*-alist} variables. Clean-ups are 975provided by the @code{c-hanging-*-alist} variables. Clean-ups are
976however used to adjust code ``after-the-fact,'' i.e. to adjust the 976however used to adjust code ``after-the-fact,'' i.e., to adjust the
977whitespace in constructs after they are typed. 977whitespace in constructs after they are typed.
978 978
979Most of the clean-ups are only applicable to counteract automatically 979Most of the clean-ups are only applicable to counteract automatically
@@ -1146,7 +1146,7 @@ minor mode:
1146@item space-before-funcall 1146@item space-before-funcall
1147Insert a space between the function name and the opening parenthesis of 1147Insert a space between the function name and the opening parenthesis of
1148a function call. This produces function calls in the style mandated by 1148a function call. This produces function calls in the style mandated by
1149the GNU coding standards, e.g. @samp{signal (SIGINT, SIG_IGN)} and 1149the GNU coding standards, e.g., @samp{signal (SIGINT, SIG_IGN)} and
1150@samp{abort ()}. Clean up occurs when the opening parenthesis is typed. 1150@samp{abort ()}. Clean up occurs when the opening parenthesis is typed.
1151 1151
1152@item compact-empty-funcall 1152@item compact-empty-funcall
@@ -1154,7 +1154,7 @@ Clean up any space between the function name and the opening parenthesis
1154of a function call that has no arguments. This is typically used 1154of a function call that has no arguments. This is typically used
1155together with @code{space-before-funcall} if you prefer the GNU function 1155together with @code{space-before-funcall} if you prefer the GNU function
1156call style for functions with arguments but think it looks ugly when 1156call style for functions with arguments but think it looks ugly when
1157it's only an empty parenthesis pair. I.e. you will get @samp{signal 1157it's only an empty parenthesis pair. I.e., you will get @samp{signal
1158(SIGINT, SIG_IGN)}, but @samp{abort()}. Clean up occurs when the 1158(SIGINT, SIG_IGN)}, but @samp{abort()}. Clean up occurs when the
1159closing parenthesis is typed. 1159closing parenthesis is typed.
1160@end table 1160@end table
@@ -1278,7 +1278,7 @@ whether hungry-delete mode is enabled or not).
1278 1278
1279Since there's a lot of normal text in comments and string literals, 1279Since there's a lot of normal text in comments and string literals,
1280@ccmode{} provides features to edit these like in text mode. The goal 1280@ccmode{} provides features to edit these like in text mode. The goal
1281is to do it as seamlessly as possible, i.e. you can use auto fill mode, 1281is to do it as seamlessly as possible, i.e., you can use auto fill mode,
1282sentence and paragraph movement, paragraph filling, adaptive filling etc 1282sentence and paragraph movement, paragraph filling, adaptive filling etc
1283wherever there's a piece of normal text without having to think much 1283wherever there's a piece of normal text without having to think much
1284about it. @ccmode{} should keep the indentation, fix the comment line 1284about it. @ccmode{} should keep the indentation, fix the comment line
@@ -1333,7 +1333,7 @@ like
1333@noindent 1333@noindent
1334with zero or more stars at the beginning of every line. If you change 1334with zero or more stars at the beginning of every line. If you change
1335this variable, please make sure it still matches the comment starter 1335this variable, please make sure it still matches the comment starter
1336(i.e. @code{//}) of line comments @emph{and} the line prefix inside 1336(i.e., @code{//}) of line comments @emph{and} the line prefix inside
1337block comments. 1337block comments.
1338 1338
1339@findex c-setup-paragraph-variables 1339@findex c-setup-paragraph-variables
@@ -1352,7 +1352,7 @@ mode hook, since @ccmode{} sets up all variables before calling them.
1352@cindex paragraph filling 1352@cindex paragraph filling
1353Line breaks are by default handled (almost) the same regardless whether 1353Line breaks are by default handled (almost) the same regardless whether
1354they are made by auto fill mode (@pxref{Auto Fill,,, emacs, The Emacs 1354they are made by auto fill mode (@pxref{Auto Fill,,, emacs, The Emacs
1355Editor}), paragraph filling (e.g. with @kbd{M-q}), or explicitly with 1355Editor}), paragraph filling (e.g., with @kbd{M-q}), or explicitly with
1356@kbd{M-j} or similar methods. In string literals, the new line gets the 1356@kbd{M-j} or similar methods. In string literals, the new line gets the
1357same indentation as the previous nonempty line (may be changed with the 1357same indentation as the previous nonempty line (may be changed with the
1358@code{string} syntactic symbol). In comments, @ccmode{} uses 1358@code{string} syntactic symbol). In comments, @ccmode{} uses
@@ -1364,7 +1364,7 @@ lines in the comment.
1364@ccmode{} uses adaptive fill mode (@pxref{Adaptive Fill,,, emacs, The 1364@ccmode{} uses adaptive fill mode (@pxref{Adaptive Fill,,, emacs, The
1365Emacs Editor}) to make Emacs correctly keep the line prefix when filling 1365Emacs Editor}) to make Emacs correctly keep the line prefix when filling
1366paragraphs. That also makes Emacs preserve the text indentation 1366paragraphs. That also makes Emacs preserve the text indentation
1367@emph{inside} the comment line prefix. E.g. in the following comment, 1367@emph{inside} the comment line prefix. e.g., in the following comment,
1368both paragraphs will be filled with the left margins of the texts kept 1368both paragraphs will be filled with the left margins of the texts kept
1369intact: 1369intact:
1370 1370
@@ -1394,7 +1394,7 @@ by default). A patch for that is available from
1394@uref{http://cc-mode.sourceforge.net/,, the CC Mode web site}.}, 1394@uref{http://cc-mode.sourceforge.net/,, the CC Mode web site}.},
1395which handles things like bulleted lists nicely. There's a convenience 1395which handles things like bulleted lists nicely. There's a convenience
1396function @code{c-setup-filladapt} that tunes the relevant variables in 1396function @code{c-setup-filladapt} that tunes the relevant variables in
1397Filladapt for use in @ccmode{}. Call it from a mode hook, e.g. with 1397Filladapt for use in @ccmode{}. Call it from a mode hook, e.g., with
1398something like this in your @file{.emacs}: 1398something like this in your @file{.emacs}:
1399 1399
1400@example 1400@example
@@ -1443,7 +1443,7 @@ most common comment styles, see @ref{Indentation Functions}.
1443@defopt c-ignore-auto-fill 1443@defopt c-ignore-auto-fill
1444@vindex ignore-auto-fill (c-) 1444@vindex ignore-auto-fill (c-)
1445When auto fill mode is enabled, @ccmode{} can selectively ignore it 1445When auto fill mode is enabled, @ccmode{} can selectively ignore it
1446depending on the context the line break would occur in, e.g. to never 1446depending on the context the line break would occur in, e.g., to never
1447break a line automatically inside a string literal. This variable 1447break a line automatically inside a string literal. This variable
1448takes a list of symbols for the different contexts where auto-filling 1448takes a list of symbols for the different contexts where auto-filling
1449never should occur: 1449never should occur:
@@ -1458,7 +1458,7 @@ Inside a C++ style line comment.
1458@item cpp 1458@item cpp
1459Inside a preprocessor directive. 1459Inside a preprocessor directive.
1460@item code 1460@item code
1461Anywhere else, i.e. in normal code. 1461Anywhere else, i.e., in normal code.
1462@end table 1462@end table
1463 1463
1464By default, @code{c-ignore-auto-fill} is set to @code{'(string cpp 1464By default, @code{c-ignore-auto-fill} is set to @code{'(string cpp
@@ -1514,7 +1514,7 @@ Note that @ccmode{} sets @code{comment-multi-line} to @code{t} at
1514startup. The reason is that @kbd{M-j} could otherwise produce sequences 1514startup. The reason is that @kbd{M-j} could otherwise produce sequences
1515of single line block comments for texts that should logically be treated 1515of single line block comments for texts that should logically be treated
1516as one comment, and the rest of the paragraph handling code 1516as one comment, and the rest of the paragraph handling code
1517(e.g. @kbd{M-q} and @kbd{M-a}) can't cope with that, which would lead to 1517(e.g., @kbd{M-q} and @kbd{M-a}) can't cope with that, which would lead to
1518inconsistent behavior. 1518inconsistent behavior.
1519 1519
1520@item @kbd{M-x c-context-line-break} 1520@item @kbd{M-x c-context-line-break}
@@ -1523,7 +1523,7 @@ inconsistent behavior.
1523This is a function that works like @code{indent-new-comment-line} in 1523This is a function that works like @code{indent-new-comment-line} in
1524comments and @code{newline-and-indent} elsewhere, thus combining those 1524comments and @code{newline-and-indent} elsewhere, thus combining those
1525two in a way that uses each one in the context it's best suited for. 1525two in a way that uses each one in the context it's best suited for.
1526I.e. in comments the comment line prefix and indentation is kept for 1526I.e., in comments the comment line prefix and indentation is kept for
1527the new line, and in normal code it's indented according to context by 1527the new line, and in normal code it's indented according to context by
1528the indentation engine. 1528the indentation engine.
1529 1529
@@ -1540,7 +1540,7 @@ It's not bound to a key by default, but it's intended to be used on the
1540@findex c-context-open-line 1540@findex c-context-open-line
1541@findex context-open-line (c-) 1541@findex context-open-line (c-)
1542This is to @kbd{C-o} (@kbd{M-x open-line}) as 1542This is to @kbd{C-o} (@kbd{M-x open-line}) as
1543@code{c-context-line-break} is to @kbd{RET}. I.e. it works just like 1543@code{c-context-line-break} is to @kbd{RET}. I.e., it works just like
1544@code{c-context-line-break} but leaves the point before the inserted 1544@code{c-context-line-break} but leaves the point before the inserted
1545line break. 1545line break.
1546@end table 1546@end table
@@ -1555,13 +1555,13 @@ line break.
1555@comment !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! 1555@comment !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
1556 1556
1557Preprocessor directives are handled as syntactic whitespace from other 1557Preprocessor directives are handled as syntactic whitespace from other
1558code, i.e. they can be interspersed anywhere without affecting the 1558code, i.e., they can be interspersed anywhere without affecting the
1559syntactic analysis, just like comments. 1559syntactic analysis, just like comments.
1560 1560
1561The code inside macro definitions is still analyzed syntactically so 1561The code inside macro definitions is still analyzed syntactically so
1562that you get relative indentation there just as you'd get if the same 1562that you get relative indentation there just as you'd get if the same
1563code was outside a macro. However, since there is no hint about the 1563code was outside a macro. However, since there is no hint about the
1564syntactic context, i.e. whether the macro expands to an expression, to some 1564syntactic context, i.e., whether the macro expands to an expression, to some
1565statements, or perhaps to whole functions, the syntactic recognition can be 1565statements, or perhaps to whole functions, the syntactic recognition can be
1566wrong. @ccmode{} manages to figure it out correctly most of the time, 1566wrong. @ccmode{} manages to figure it out correctly most of the time,
1567though. @xref{Syntactic Symbols}, for details about the indentation. 1567though. @xref{Syntactic Symbols}, for details about the indentation.
@@ -1601,7 +1601,7 @@ the region ends at the start of a line, it always deletes the backslash
1601These variables control the alignment columns for line continuation 1601These variables control the alignment columns for line continuation
1602backslashes in multiline macros. They are used by the functions that 1602backslashes in multiline macros. They are used by the functions that
1603automatically insert or align such backslashes, 1603automatically insert or align such backslashes,
1604e.g. @code{c-backslash-region} and @code{c-context-line-break}. 1604e.g., @code{c-backslash-region} and @code{c-context-line-break}.
1605 1605
1606@code{c-backslash-column} specifies the minimum column for the 1606@code{c-backslash-column} specifies the minimum column for the
1607backslashes. If any line in the macro exceeds it then the next tab 1607backslashes. If any line in the macro exceeds it then the next tab
@@ -1616,7 +1616,7 @@ lines which are too long ``stick out'' instead.
1616@vindex auto-align-backslashes (c-) 1616@vindex auto-align-backslashes (c-)
1617Align automatically inserted line continuation backslashes if 1617Align automatically inserted line continuation backslashes if
1618non-@code{nil}. When line continuation backslashes are inserted 1618non-@code{nil}. When line continuation backslashes are inserted
1619automatically for line breaks in multiline macros, e.g. by 1619automatically for line breaks in multiline macros, e.g., by
1620@code{c-context-line-break}, they are aligned with the other backslashes 1620@code{c-context-line-break}, they are aligned with the other backslashes
1621in the same macro if this flag is set. Otherwise the inserted 1621in the same macro if this flag is set. Otherwise the inserted
1622backslashes are preceded by a single space. 1622backslashes are preceded by a single space.
@@ -1738,7 +1738,7 @@ additional regexps to match those you use:
1738For each language there's a variable @code{*-font-lock-extra-types}, 1738For each language there's a variable @code{*-font-lock-extra-types},
1739where @samp{*} stands for the language in question. It contains a list 1739where @samp{*} stands for the language in question. It contains a list
1740of regexps that matches identifiers that should be recognized as types, 1740of regexps that matches identifiers that should be recognized as types,
1741e.g. @samp{\\sw+_t} to recognize all identifiers ending with @samp{_t} 1741e.g., @samp{\\sw+_t} to recognize all identifiers ending with @samp{_t}
1742as is customary in C code. Each regexp should not match more than a 1742as is customary in C code. Each regexp should not match more than a
1743single identifier. 1743single identifier.
1744 1744
@@ -1835,7 +1835,7 @@ labels.
1835@vindex font-lock-builtin-face 1835@vindex font-lock-builtin-face
1836@vindex font-lock-reference-face 1836@vindex font-lock-reference-face
1837Preprocessor directives get @code{font-lock-preprocessor-face} if it 1837Preprocessor directives get @code{font-lock-preprocessor-face} if it
1838exists (i.e. XEmacs). In Emacs they get @code{font-lock-builtin-face} 1838exists (i.e., XEmacs). In Emacs they get @code{font-lock-builtin-face}
1839or @code{font-lock-reference-face}, for lack of a closer equivalent. 1839or @code{font-lock-reference-face}, for lack of a closer equivalent.
1840 1840
1841@item 1841@item
@@ -1861,14 +1861,14 @@ since those aren't syntactic errors in themselves.
1861@comment !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! 1861@comment !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
1862 1862
1863There are various tools to supply documentation in the source as 1863There are various tools to supply documentation in the source as
1864specially structured comments, e.g. the standard Javadoc tool in Java. 1864specially structured comments, e.g., the standard Javadoc tool in Java.
1865@ccmode{} provides an extensible mechanism to fontify such comments and 1865@ccmode{} provides an extensible mechanism to fontify such comments and
1866the special markup inside them. 1866the special markup inside them.
1867 1867
1868@defopt c-doc-comment-style 1868@defopt c-doc-comment-style
1869@vindex doc-comment-style (c-) 1869@vindex doc-comment-style (c-)
1870This is a style variable that specifies which documentation comment 1870This is a style variable that specifies which documentation comment
1871style to recognize, e.g. @code{javadoc} for Javadoc comments. 1871style to recognize, e.g., @code{javadoc} for Javadoc comments.
1872 1872
1873The value may also be a list of styles, in which case all of them are 1873The value may also be a list of styles, in which case all of them are
1874recognized simultaneously (presumably with markup cues that don't 1874recognized simultaneously (presumably with markup cues that don't
@@ -1883,7 +1883,7 @@ and its value is used instead.
1883Note that @ccmode{} uses this variable to set other variables that 1883Note that @ccmode{} uses this variable to set other variables that
1884handle fontification etc. That's done at mode initialization or when 1884handle fontification etc. That's done at mode initialization or when
1885you switch to a style which sets this variable. Thus, if you change it 1885you switch to a style which sets this variable. Thus, if you change it
1886in some other way, e.g. interactively in a CC Mode buffer, you will need 1886in some other way, e.g., interactively in a CC Mode buffer, you will need
1887to do @kbd{M-x java-mode} (or whatever mode you're currently using) to 1887to do @kbd{M-x java-mode} (or whatever mode you're currently using) to
1888reinitialize. 1888reinitialize.
1889 1889
@@ -1993,7 +1993,7 @@ Indents the entire top-level function, class or macro definition
1993encompassing point. It leaves point unchanged. This function can't be 1993encompassing point. It leaves point unchanged. This function can't be
1994used to reindent a nested brace construct, such as a nested class or 1994used to reindent a nested brace construct, such as a nested class or
1995function, or a Java method. The top-level construct being reindented 1995function, or a Java method. The top-level construct being reindented
1996must be complete, i.e. it must have both a beginning brace and an ending 1996must be complete, i.e., it must have both a beginning brace and an ending
1997brace. 1997brace.
1998 1998
1999@item @kbd{C-M-\} (@code{indent-region}) 1999@item @kbd{C-M-\} (@code{indent-region})
@@ -2239,7 +2239,7 @@ whether to do sentence motion in or near comments and multiline strings.
2239A popular programming style, especially for object-oriented languages 2239A popular programming style, especially for object-oriented languages
2240such as C++ is to write symbols in a mixed case format, where the first 2240such as C++ is to write symbols in a mixed case format, where the first
2241letter of each word is capitalized, and not separated by underscores. 2241letter of each word is capitalized, and not separated by underscores.
2242E.g. @samp{SymbolsWithMixedCaseAndNoUnderlines}. 2242e.g., @samp{SymbolsWithMixedCaseAndNoUnderlines}.
2243 2243
2244This command moves point forward to next capitalized word. With prefix 2244This command moves point forward to next capitalized word. With prefix
2245argument @var{n}, move @var{n} times. 2245argument @var{n}, move @var{n} times.
@@ -2295,7 +2295,7 @@ styles.
2295Only syntactic symbols not already bound on @code{c-offsets-alist} will 2295Only syntactic symbols not already bound on @code{c-offsets-alist} will
2296be set from styles. This means that any association you set on it, be 2296be set from styles. This means that any association you set on it, be
2297it before or after mode initialization, will not be changed. The 2297it before or after mode initialization, will not be changed. The
2298@code{c-offsets-alist} variable may therefore be used from e.g. the 2298@code{c-offsets-alist} variable may therefore be used from e.g., the
2299Customization interface@footnote{Available in Emacs 20 and later, and 2299Customization interface@footnote{Available in Emacs 20 and later, and
2300XEmacs 19.15 and later.} to easily change indentation offsets without 2300XEmacs 19.15 and later.} to easily change indentation offsets without
2301having to bother about styles. Initially @code{c-offsets-alist} is 2301having to bother about styles. Initially @code{c-offsets-alist} is
@@ -2563,7 +2563,7 @@ this manual does not cover how that works.
2563 2563
2564Variables set like this at the top level in @file{.emacs} take effect in 2564Variables set like this at the top level in @file{.emacs} take effect in
2565all @ccmode{} buffers, regardless of language. The indentation style 2565all @ccmode{} buffers, regardless of language. The indentation style
2566related variables, e.g. @code{c-offsets-alist}, that you don't set this 2566related variables, e.g., @code{c-offsets-alist}, that you don't set this
2567way get their value from the style system (@pxref{Styles}), and they 2567way get their value from the style system (@pxref{Styles}), and they
2568therefore depend on the setting of @code{c-default-style}. Note that if 2568therefore depend on the setting of @code{c-default-style}. Note that if
2569you use Customize, this means that the greyed-out default values 2569you use Customize, this means that the greyed-out default values
@@ -2571,7 +2571,7 @@ presented there might not be the ones you actually get, since the actual
2571values depend on the style, which may very well be different for 2571values depend on the style, which may very well be different for
2572different languages. 2572different languages.
2573 2573
2574If you want to make more advanced configurations, e.g. language-specific 2574If you want to make more advanced configurations, e.g., language-specific
2575customization, setting global variables isn't enough. For that you can 2575customization, setting global variables isn't enough. For that you can
2576use the language hooks, see @ref{Hooks}, and/or the style system, see 2576use the language hooks, see @ref{Hooks}, and/or the style system, see
2577@ref{Styles}. 2577@ref{Styles}.
@@ -2940,8 +2940,8 @@ This variable takes an association list similar to what is allowed in
2940automatically institute these offsets using @code{c-set-offset}. 2940automatically institute these offsets using @code{c-set-offset}.
2941@end defvar 2941@end defvar
2942 2942
2943Note that file style settings (i.e. @code{c-file-style}) are applied 2943Note that file style settings (i.e., @code{c-file-style}) are applied
2944before file offset settings (i.e. @code{c-file-offsets}). Also, if 2944before file offset settings (i.e., @code{c-file-offsets}). Also, if
2945either of these are set in a file's local variable section, all the 2945either of these are set in a file's local variable section, all the
2946style variable values are made local to that buffer. 2946style variable values are made local to that buffer.
2947 2947
@@ -3086,7 +3086,7 @@ These @var{action} functions are called with two arguments: the
3086syntactic symbol for the brace, and the buffer position at which the 3086syntactic symbol for the brace, and the buffer position at which the
3087brace was inserted. The @var{action} function is expected to return a 3087brace was inserted. The @var{action} function is expected to return a
3088list containing some combination of @code{before} and @code{after}, 3088list containing some combination of @code{before} and @code{after},
3089including neither of them (i.e. @code{nil}). This return value has the 3089including neither of them (i.e., @code{nil}). This return value has the
3090normal brace hanging semantics. 3090normal brace hanging semantics.
3091 3091
3092As an example, @ccmode{} itself uses this feature to dynamically 3092As an example, @ccmode{} itself uses this feature to dynamically
@@ -3181,7 +3181,7 @@ No determination is made, and the next function in the list is called.
3181If every function in the list is called without a determination being 3181If every function in the list is called without a determination being
3182made, then no newline is added. The default value for this variable is a 3182made, then no newline is added. The default value for this variable is a
3183list containing a single function which inserts newlines only after 3183list containing a single function which inserts newlines only after
3184semicolons which do not appear inside parenthesis lists (i.e. those 3184semicolons which do not appear inside parenthesis lists (i.e., those
3185that separate @code{for}-clause statements). 3185that separate @code{for}-clause statements).
3186@end defopt 3186@end defopt
3187 3187
@@ -3215,7 +3215,7 @@ statements. In addition to
3215@ccmode{} also comes with the criteria function 3215@ccmode{} also comes with the criteria function
3216@code{c-semi&comma-no-newlines-for-oneline-inliners}, which suppresses 3216@code{c-semi&comma-no-newlines-for-oneline-inliners}, which suppresses
3217newlines after semicolons inside one-line inline method definitions 3217newlines after semicolons inside one-line inline method definitions
3218(e.g. in C++ or Java). 3218(e.g., in C++ or Java).
3219@end defun 3219@end defun
3220 3220
3221 3221
@@ -3242,7 +3242,7 @@ every line is indented by @ccmode{}. You can use it to do any special
3242indentation or line adjustments your style dictates, such as adding 3242indentation or line adjustments your style dictates, such as adding
3243extra indentation to constructors or destructor declarations in a 3243extra indentation to constructors or destructor declarations in a
3244class definition, etc. Note that you should not change point or mark 3244class definition, etc. Note that you should not change point or mark
3245inside your @code{c-special-indent-hook} functions, i.e. you'll 3245inside your @code{c-special-indent-hook} functions, i.e., you'll
3246probably want to wrap your function in a @code{save-excursion}. 3246probably want to wrap your function in a @code{save-excursion}.
3247 3247
3248Setting @code{c-special-indent-hook} in your style definition is 3248Setting @code{c-special-indent-hook} in your style definition is
@@ -3388,7 +3388,7 @@ Lines continuing an Objective-C method definition.
3388@item objc-method-call-cont 3388@item objc-method-call-cont
3389Lines continuing an Objective-C method call. 3389Lines continuing an Objective-C method call.
3390@item extern-lang-open 3390@item extern-lang-open
3391Brace that opens an @code{extern} block (e.g. @code{extern "C" @{...@}}). 3391Brace that opens an @code{extern} block (e.g., @code{extern "C" @{...@}}).
3392@item extern-lang-close 3392@item extern-lang-close
3393Brace that closes an @code{extern} block. 3393Brace that closes an @code{extern} block.
3394@item inextern-lang 3394@item inextern-lang
@@ -3411,9 +3411,9 @@ Analogous to the above, but for CORBA CIDL @code{composition} blocks.
3411C++ template argument list continuations. 3411C++ template argument list continuations.
3412@item inlambda 3412@item inlambda
3413Analogous to @code{inclass} syntactic symbol, but used inside lambda 3413Analogous to @code{inclass} syntactic symbol, but used inside lambda
3414(i.e. anonymous) functions. Only used in Pike mode. 3414(i.e., anonymous) functions. Only used in Pike mode.
3415@item lambda-intro-cont 3415@item lambda-intro-cont
3416Lines continuing the header of a lambda function, i.e. between the 3416Lines continuing the header of a lambda function, i.e., between the
3417@code{lambda} keyword and the function body. Only used in Pike mode. 3417@code{lambda} keyword and the function body. Only used in Pike mode.
3418@item inexpr-statement 3418@item inexpr-statement
3419A statement block inside an expression. The gcc C extension of this is 3419A statement block inside an expression. The gcc C extension of this is
@@ -3468,7 +3468,7 @@ top-level construct introduction so it has the syntax
3468the brace that opens a top-level function definition. Line 9 is the 3468the brace that opens a top-level function definition. Line 9 is the
3469corresponding 3469corresponding
3470@code{defun-close} since it contains the brace that closes the top-level 3470@code{defun-close} since it contains the brace that closes the top-level
3471function definition. Line 4 is a @code{defun-block-intro}, i.e. it is 3471function definition. Line 4 is a @code{defun-block-intro}, i.e., it is
3472the first line of a brace-block, enclosed in a 3472the first line of a brace-block, enclosed in a
3473top-level function definition. 3473top-level function definition.
3474 3474
@@ -3793,7 +3793,7 @@ where @code{inextern-lang} is a modifier similar in purpose to
3793 3793
3794There are various other top level blocks like @code{extern}, and they 3794There are various other top level blocks like @code{extern}, and they
3795are all treated in the same way except that the symbols are named after 3795are all treated in the same way except that the symbols are named after
3796the keyword that introduces the block. E.g. C++ namespace blocks get 3796the keyword that introduces the block. e.g., C++ namespace blocks get
3797the three symbols @code{namespace-open}, @code{namespace-close} and 3797the three symbols @code{namespace-open}, @code{namespace-close} and
3798@code{innamespace}. The currently recognized top level blocks are: 3798@code{innamespace}. The currently recognized top level blocks are:
3799 3799
@@ -3950,9 +3950,9 @@ Line 17 is assigned @code{stream-op} syntax.
3950@cindex syntactic whitespace 3950@cindex syntactic whitespace
3951@ssindex cpp-define-intro 3951@ssindex cpp-define-intro
3952Multiline preprocessor macro definitions are normally handled just like 3952Multiline preprocessor macro definitions are normally handled just like
3953other code, i.e. the lines inside them are indented according to the 3953other code, i.e., the lines inside them are indented according to the
3954syntactic analysis of the preceding lines inside the macro. The first 3954syntactic analysis of the preceding lines inside the macro. The first
3955line inside a macro definition (i.e. the line after the starting line of 3955line inside a macro definition (i.e., the line after the starting line of
3956the cpp directive itself) gets @code{cpp-define-intro}. In this example: 3956the cpp directive itself) gets @code{cpp-define-intro}. In this example:
3957 3957
3958@example 3958@example
@@ -3968,7 +3968,7 @@ line 1 is given the syntactic symbol @code{cpp-macro}. The first line
3968of a cpp directive is always given that symbol. Line 2 is given 3968of a cpp directive is always given that symbol. Line 2 is given
3969@code{cpp-define-intro}, so that you can give the macro body as a whole 3969@code{cpp-define-intro}, so that you can give the macro body as a whole
3970some extra indentation. Lines 3 through 5 are then analyzed as normal 3970some extra indentation. Lines 3 through 5 are then analyzed as normal
3971code, i.e. @code{substatement} on lines 3 and 4, and @code{else-clause} 3971code, i.e., @code{substatement} on lines 3 and 4, and @code{else-clause}
3972on line 5. 3972on line 5.
3973 3973
3974The syntactic analysis inside macros can be turned off with 3974The syntactic analysis inside macros can be turned off with
@@ -4094,7 +4094,7 @@ code @footnote{a.k.a. K&R C, or Kernighan & Ritchie C}:
4094 4094
4095Here, line 2 is the first line in an argument declaration list and so is 4095Here, line 2 is the first line in an argument declaration list and so is
4096given the @code{knr-argdecl-intro} syntactic symbol. Subsequent lines 4096given the @code{knr-argdecl-intro} syntactic symbol. Subsequent lines
4097(i.e. lines 3 and 4 in this example), are given @code{knr-argdecl} 4097(i.e., lines 3 and 4 in this example), are given @code{knr-argdecl}
4098syntax. 4098syntax.
4099 4099
4100 4100
@@ -4322,7 +4322,7 @@ if ( x < 10
4322 4322
4323Since this function doesn't do anything for lines without an infix 4323Since this function doesn't do anything for lines without an infix
4324operator you typically want to use it together with some other lineup 4324operator you typically want to use it together with some other lineup
4325settings, e.g. as follows (the @code{arglist-close} setting is just a 4325settings, e.g., as follows (the @code{arglist-close} setting is just a
4326suggestion to get a consistent style): 4326suggestion to get a consistent style):
4327 4327
4328@example 4328@example
@@ -4383,7 +4383,7 @@ to handle most of the common comment styles. Some examples:
4383@end example 4383@end example
4384 4384
4385The style variable @code{c-comment-prefix-regexp} is used to recognize 4385The style variable @code{c-comment-prefix-regexp} is used to recognize
4386the comment line prefix, e.g. the @samp{*} that usually starts every 4386the comment line prefix, e.g., the @samp{*} that usually starts every
4387line inside a comment. 4387line inside a comment.
4388 4388
4389@workswith The @code{c} syntactic symbol. 4389@workswith The @code{c} syntactic symbol.
@@ -4512,7 +4512,7 @@ int dribble() @{
4512 4512
4513If @code{c-syntactic-indentation-in-macros} is non-@code{nil}, the 4513If @code{c-syntactic-indentation-in-macros} is non-@code{nil}, the
4514function returns the relative indentation to the macro start line to 4514function returns the relative indentation to the macro start line to
4515allow accumulation with other offsets. E.g. in the following cases, 4515allow accumulation with other offsets. e.g., in the following cases,
4516@code{cpp-define-intro} is combined with the 4516@code{cpp-define-intro} is combined with the
4517@code{statement-block-intro} that comes from the @samp{do @{} that hangs 4517@code{statement-block-intro} that comes from the @samp{do @{} that hangs
4518on the @samp{#define} line: 4518on the @samp{#define} line:
@@ -4611,7 +4611,7 @@ arglist lineups, e.g.
4611@defun c-lineup-inexpr-block 4611@defun c-lineup-inexpr-block
4612@findex lineup-inexpr-block (c-) 4612@findex lineup-inexpr-block (c-)
4613This can be used with the in-expression block symbols to indent the 4613This can be used with the in-expression block symbols to indent the
4614whole block to the column where the construct is started. E.g. for Java 4614whole block to the column where the construct is started. e.g., for Java
4615anonymous classes, this lines up the class under the @samp{new} keyword, 4615anonymous classes, this lines up the class under the @samp{new} keyword,
4616and in Pike it lines up the lambda function body under the @samp{lambda} 4616and in Pike it lines up the lambda function body under the @samp{lambda}
4617keyword. Returns @code{nil} if the block isn't part of such a 4617keyword. Returns @code{nil} if the block isn't part of such a
@@ -4828,7 +4828,7 @@ expressions.
4828 4828
4829@defun c-lineup-streamop 4829@defun c-lineup-streamop
4830@findex lineup-streamop (c-) 4830@findex lineup-streamop (c-)
4831Line up C++ stream operators (i.e. @samp{<<} and @samp{>>}). 4831Line up C++ stream operators (i.e., @samp{<<} and @samp{>>}).
4832 4832
4833@workswith @code{stream-op}. 4833@workswith @code{stream-op}.
4834@end defun 4834@end defun
@@ -4956,7 +4956,7 @@ In the first case the indentation is kept unchanged, in the second
4956@workswith @code{defun-close}, @code{defun-block-intro}, 4956@workswith @code{defun-close}, @code{defun-block-intro},
4957@code{block-close}, @code{brace-list-close}, @code{brace-list-intro}, 4957@code{block-close}, @code{brace-list-close}, @code{brace-list-intro},
4958@code{statement-block-intro} and all @code{in*} symbols, 4958@code{statement-block-intro} and all @code{in*} symbols,
4959e.g. @code{inclass} and @code{inextern-lang}. 4959e.g., @code{inclass} and @code{inextern-lang}.
4960@end defun 4960@end defun
4961 4961
4962 4962
@@ -5050,7 +5050,7 @@ pairs. See @ref{AWK Mode Defuns} for a description of commands which
5050work on AWK ``defuns''. 5050work on AWK ``defuns''.
5051 5051
5052Since there is no preprocessor in AWK, the commands which move to 5052Since there is no preprocessor in AWK, the commands which move to
5053preprocessor directives (e.g. @code{c-up-conditional}) are meaningless 5053preprocessor directives (e.g., @code{c-up-conditional}) are meaningless
5054in AWK mode and are not bound in the AWK mode keymap. 5054in AWK mode and are not bound in the AWK mode keymap.
5055 5055
5056@item Auto-newline Insertion and Clean-ups 5056@item Auto-newline Insertion and Clean-ups
@@ -5230,7 +5230,7 @@ present on the association list, CC Mode won't set
5230 5230
5231The default is to set @code{require-final-newline} to @code{t} in the 5231The default is to set @code{require-final-newline} to @code{t} in the
5232languages that mandates that source files should end with newlines, 5232languages that mandates that source files should end with newlines,
5233i.e. C, C++ and Objective-C. 5233i.e., C, C++ and Objective-C.
5234@end defopt 5234@end defopt
5235 5235
5236@defopt c-echo-syntactic-information-p 5236@defopt c-echo-syntactic-information-p
@@ -5271,9 +5271,9 @@ pathological code can cause @ccmode{} to perform fairly badly. This
5271section gives some insight in how @ccmode{} operates, how that interacts 5271section gives some insight in how @ccmode{} operates, how that interacts
5272with some coding styles, and what you can use to improve performance. 5272with some coding styles, and what you can use to improve performance.
5273 5273
5274The overall goal is that @ccmode{} shouldn't be overly slow (i.e. take 5274The overall goal is that @ccmode{} shouldn't be overly slow (i.e., take
5275more than a fraction of a second) in any interactive operation. 5275more than a fraction of a second) in any interactive operation.
5276I.e. it's tuned to limit the maximum response time in single operations, 5276i.e., it's tuned to limit the maximum response time in single operations,
5277which sometimes is at the expense of batch-like operations like 5277which sometimes is at the expense of batch-like operations like
5278reindenting whole blocks. If you find that @ccmode{} gradually gets 5278reindenting whole blocks. If you find that @ccmode{} gradually gets
5279slower and slower in certain situations, perhaps as the file grows in 5279slower and slower in certain situations, perhaps as the file grows in
@@ -5292,7 +5292,7 @@ gets.
5292@findex beginning-of-defun 5292@findex beginning-of-defun
5293@findex defun-prompt-regexp 5293@findex defun-prompt-regexp
5294One of the simplest things you can do to reduce scan time, is make sure 5294One of the simplest things you can do to reduce scan time, is make sure
5295any brace that opens a top-level construct@footnote{E.g. a function in 5295any brace that opens a top-level construct@footnote{e.g., a function in
5296C, or outermost class definition in C++ or Java.} always appears in the 5296C, or outermost class definition in C++ or Java.} always appears in the
5297leftmost column. This is actually an Emacs constraint, as embodied in 5297leftmost column. This is actually an Emacs constraint, as embodied in
5298the @code{beginning-of-defun} function which @ccmode{} uses heavily. If 5298the @code{beginning-of-defun} function which @ccmode{} uses heavily. If
@@ -5334,7 +5334,7 @@ XEmacs users can set the variable
5334tells @ccmode{} to use XEmacs-specific built-in functions which, in some 5334tells @ccmode{} to use XEmacs-specific built-in functions which, in some
5335circumstances, can locate the top-most opening brace much more quickly than 5335circumstances, can locate the top-most opening brace much more quickly than
5336@code{beginning-of-defun}. Preliminary testing has shown that for 5336@code{beginning-of-defun}. Preliminary testing has shown that for
5337styles where these braces are hung (e.g. most JDK-derived Java styles), 5337styles where these braces are hung (e.g., most JDK-derived Java styles),
5338this hack can improve performance of the core syntax parsing routines 5338this hack can improve performance of the core syntax parsing routines
5339from 3 to 60 times. However, for styles which @emph{do} conform to 5339from 3 to 60 times. However, for styles which @emph{do} conform to
5340Emacs' recommended style of putting top-level braces in column zero, 5340Emacs' recommended style of putting top-level braces in column zero,
@@ -5345,7 +5345,7 @@ in Emacs since the necessary built-in functions don't exist (in Emacs
534521.3 as of this writing in May 2003). 534521.3 as of this writing in May 2003).
5346 5346
5347Text properties are used to speed up skipping over syntactic whitespace, 5347Text properties are used to speed up skipping over syntactic whitespace,
5348i.e. comments and preprocessor directives. Indenting a line after a 5348i.e., comments and preprocessor directives. Indenting a line after a
5349huge macro definition can be slow the first time, but after that the 5349huge macro definition can be slow the first time, but after that the
5350text properties are in place and it should be fast (even after you've 5350text properties are in place and it should be fast (even after you've
5351edited other parts of the file and then moved back). 5351edited other parts of the file and then moved back).
@@ -5353,7 +5353,7 @@ edited other parts of the file and then moved back).
5353Font locking can be a CPU hog, especially the font locking done on 5353Font locking can be a CPU hog, especially the font locking done on
5354decoration level 3 which tries to be very accurate. Note that that 5354decoration level 3 which tries to be very accurate. Note that that
5355level is designed to be used with a font lock support mode that only 5355level is designed to be used with a font lock support mode that only
5356fontifies the text that's actually shown, i.e. Lazy Lock or Just-in-time 5356fontifies the text that's actually shown, i.e., Lazy Lock or Just-in-time
5357Lock mode, so make sure you use one of them. Fontification of a whole 5357Lock mode, so make sure you use one of them. Fontification of a whole
5358buffer with some thousand lines can often take over a minute. That is 5358buffer with some thousand lines can often take over a minute. That is
5359a known weakness; the idea is that it never should happen. 5359a known weakness; the idea is that it never should happen.
@@ -5386,7 +5386,7 @@ geared to be used interactively to edit new code. There's currently no
5386intention to change this goal. 5386intention to change this goal.
5387 5387
5388If you want to reformat old code, you're probably better off using some 5388If you want to reformat old code, you're probably better off using some
5389other tool instead, e.g. @ref{Top, , GNU indent, indent, The `indent' 5389other tool instead, e.g., @ref{Top, , GNU indent, indent, The `indent'
5390Manual}, which has more powerful reformatting capabilities than 5390Manual}, which has more powerful reformatting capabilities than
5391@ccmode{}. 5391@ccmode{}.
5392 5392
@@ -5526,7 +5526,7 @@ to include any code that appears @emph{before} your bug example, if
5526you think it might affect our ability to reproduce it. 5526you think it might affect our ability to reproduce it.
5527 5527
5528Please try to produce the problem in an Emacs instance without any 5528Please try to produce the problem in an Emacs instance without any
5529customizations loaded (i.e. start it with the @code{-q -no-site-file} 5529customizations loaded (i.e., start it with the @samp{-q --no-site-file}
5530arguments). If it works correctly there, the problem might be caused by 5530arguments). If it works correctly there, the problem might be caused by
5531faulty customizations in either your own or your site configuration. In 5531faulty customizations in either your own or your site configuration. In
5532that case, we'd appreciate if you isolate the Emacs Lisp code that trigs 5532that case, we'd appreciate if you isolate the Emacs Lisp code that trigs