diff options
| author | Richard M. Stallman | 2004-05-29 15:46:57 +0000 |
|---|---|---|
| committer | Richard M. Stallman | 2004-05-29 15:46:57 +0000 |
| commit | c3a2e2d5ad1ab49369e89d1989e3396920a7bf15 (patch) | |
| tree | eddc245a2a4e389d71983e5c70b32ce6228bfbef | |
| parent | 4d3867280ea96cd6252ea3f8e21d038a298f8d7e (diff) | |
| download | emacs-c3a2e2d5ad1ab49369e89d1989e3396920a7bf15.tar.gz emacs-c3a2e2d5ad1ab49369e89d1989e3396920a7bf15.zip | |
Put commas after i.e. and e.g. Minor cleanups.
| -rw-r--r-- | man/cc-mode.texi | 126 |
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} | |||
| 354 | indented to the same level as the previous one, and @kbd{TAB} | 354 | indented 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 |
| 357 | the indentation associated variables, e.g. @code{c-special-indent-hook}. | 357 | the 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 | |||
| 381 | a @dfn{syntactic symbol}, the second being a @dfn{relative | 381 | a @dfn{syntactic symbol}, the second being a @dfn{relative |
| 382 | buffer position}. Syntactic symbols describe elements of C code | 382 | buffer 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 |
| 384 | the C-like languages.}, e.g. @code{statement}, @code{substatement}, | 384 | the 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}, |
| 386 | for a complete list of currently recognized syntactic symbols and their | 386 | for a complete list of currently recognized syntactic symbols and their |
| 387 | semantics. The style variable @code{c-offsets-alist} also contains the | 387 | semantics. 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 |
| 412 | syntactic analysis is for the current line. Running this command on | 412 | syntactic analysis is for the current line. Running this command on |
| 413 | line 4 of this example, we'd see in the echo area@footnote{With a | 413 | line 4 of this example, we'd see in the echo area@footnote{With a |
| 414 | universal argument (i.e. @kbd{C-u C-c C-s}) the analysis is inserted | 414 | universal argument (i.e., @kbd{C-u C-c C-s}) the analysis is inserted |
| 415 | into the buffer as a comment on the current line.}: | 415 | into 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 | |||
| 677 | whitespace} since they are usually ignored when scanning C code.}. | 677 | whitespace} since they are usually ignored when scanning C code.}. |
| 678 | 678 | ||
| 679 | @item | 679 | @item |
| 680 | No numeric argument was supplied to the command (i.e. it was typed as | 680 | No numeric argument was supplied to the command (i.e., it was typed as |
| 681 | normal, with no @kbd{C-u} prefix). | 681 | normal, 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 | ||
| 705 | When you type either an open or close brace (i.e. @kbd{@{} or @kbd{@}}), | 705 | When you type either an open or close brace (i.e., @kbd{@{} or @kbd{@}}), |
| 706 | the electric command @code{c-electric-brace} gets run. This command has | 706 | the electric command @code{c-electric-brace} gets run. This command has |
| 707 | two electric formatting behaviors. First, it will perform some | 707 | two electric formatting behaviors. First, it will perform some |
| 708 | reindentation of the line the brace was typed on, and second, it will | 708 | reindentation 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. |
| 974 | On the surface, it would seem that clean-ups overlap the functionality | 974 | On the surface, it would seem that clean-ups overlap the functionality |
| 975 | provided by the @code{c-hanging-*-alist} variables. Clean-ups are | 975 | provided by the @code{c-hanging-*-alist} variables. Clean-ups are |
| 976 | however used to adjust code ``after-the-fact,'' i.e. to adjust the | 976 | however used to adjust code ``after-the-fact,'' i.e., to adjust the |
| 977 | whitespace in constructs after they are typed. | 977 | whitespace in constructs after they are typed. |
| 978 | 978 | ||
| 979 | Most of the clean-ups are only applicable to counteract automatically | 979 | Most 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 |
| 1147 | Insert a space between the function name and the opening parenthesis of | 1147 | Insert a space between the function name and the opening parenthesis of |
| 1148 | a function call. This produces function calls in the style mandated by | 1148 | a function call. This produces function calls in the style mandated by |
| 1149 | the GNU coding standards, e.g. @samp{signal (SIGINT, SIG_IGN)} and | 1149 | the 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 | |||
| 1154 | of a function call that has no arguments. This is typically used | 1154 | of a function call that has no arguments. This is typically used |
| 1155 | together with @code{space-before-funcall} if you prefer the GNU function | 1155 | together with @code{space-before-funcall} if you prefer the GNU function |
| 1156 | call style for functions with arguments but think it looks ugly when | 1156 | call style for functions with arguments but think it looks ugly when |
| 1157 | it's only an empty parenthesis pair. I.e. you will get @samp{signal | 1157 | it'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 |
| 1159 | closing parenthesis is typed. | 1159 | closing parenthesis is typed. |
| 1160 | @end table | 1160 | @end table |
| @@ -1278,7 +1278,7 @@ whether hungry-delete mode is enabled or not). | |||
| 1278 | 1278 | ||
| 1279 | Since there's a lot of normal text in comments and string literals, | 1279 | Since 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 |
| 1281 | is to do it as seamlessly as possible, i.e. you can use auto fill mode, | 1281 | is to do it as seamlessly as possible, i.e., you can use auto fill mode, |
| 1282 | sentence and paragraph movement, paragraph filling, adaptive filling etc | 1282 | sentence and paragraph movement, paragraph filling, adaptive filling etc |
| 1283 | wherever there's a piece of normal text without having to think much | 1283 | wherever there's a piece of normal text without having to think much |
| 1284 | about it. @ccmode{} should keep the indentation, fix the comment line | 1284 | about it. @ccmode{} should keep the indentation, fix the comment line |
| @@ -1333,7 +1333,7 @@ like | |||
| 1333 | @noindent | 1333 | @noindent |
| 1334 | with zero or more stars at the beginning of every line. If you change | 1334 | with zero or more stars at the beginning of every line. If you change |
| 1335 | this variable, please make sure it still matches the comment starter | 1335 | this 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 |
| 1337 | block comments. | 1337 | block 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 |
| 1353 | Line breaks are by default handled (almost) the same regardless whether | 1353 | Line breaks are by default handled (almost) the same regardless whether |
| 1354 | they are made by auto fill mode (@pxref{Auto Fill,,, emacs, The Emacs | 1354 | they are made by auto fill mode (@pxref{Auto Fill,,, emacs, The Emacs |
| 1355 | Editor}), paragraph filling (e.g. with @kbd{M-q}), or explicitly with | 1355 | Editor}), 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 |
| 1357 | same indentation as the previous nonempty line (may be changed with the | 1357 | same 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 |
| 1365 | Emacs Editor}) to make Emacs correctly keep the line prefix when filling | 1365 | Emacs Editor}) to make Emacs correctly keep the line prefix when filling |
| 1366 | paragraphs. That also makes Emacs preserve the text indentation | 1366 | paragraphs. 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, |
| 1368 | both paragraphs will be filled with the left margins of the texts kept | 1368 | both paragraphs will be filled with the left margins of the texts kept |
| 1369 | intact: | 1369 | intact: |
| 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}.}, |
| 1395 | which handles things like bulleted lists nicely. There's a convenience | 1395 | which handles things like bulleted lists nicely. There's a convenience |
| 1396 | function @code{c-setup-filladapt} that tunes the relevant variables in | 1396 | function @code{c-setup-filladapt} that tunes the relevant variables in |
| 1397 | Filladapt for use in @ccmode{}. Call it from a mode hook, e.g. with | 1397 | Filladapt for use in @ccmode{}. Call it from a mode hook, e.g., with |
| 1398 | something like this in your @file{.emacs}: | 1398 | something 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-) |
| 1445 | When auto fill mode is enabled, @ccmode{} can selectively ignore it | 1445 | When auto fill mode is enabled, @ccmode{} can selectively ignore it |
| 1446 | depending on the context the line break would occur in, e.g. to never | 1446 | depending on the context the line break would occur in, e.g., to never |
| 1447 | break a line automatically inside a string literal. This variable | 1447 | break a line automatically inside a string literal. This variable |
| 1448 | takes a list of symbols for the different contexts where auto-filling | 1448 | takes a list of symbols for the different contexts where auto-filling |
| 1449 | never should occur: | 1449 | never should occur: |
| @@ -1458,7 +1458,7 @@ Inside a C++ style line comment. | |||
| 1458 | @item cpp | 1458 | @item cpp |
| 1459 | Inside a preprocessor directive. | 1459 | Inside a preprocessor directive. |
| 1460 | @item code | 1460 | @item code |
| 1461 | Anywhere else, i.e. in normal code. | 1461 | Anywhere else, i.e., in normal code. |
| 1462 | @end table | 1462 | @end table |
| 1463 | 1463 | ||
| 1464 | By default, @code{c-ignore-auto-fill} is set to @code{'(string cpp | 1464 | By 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 | |||
| 1514 | startup. The reason is that @kbd{M-j} could otherwise produce sequences | 1514 | startup. The reason is that @kbd{M-j} could otherwise produce sequences |
| 1515 | of single line block comments for texts that should logically be treated | 1515 | of single line block comments for texts that should logically be treated |
| 1516 | as one comment, and the rest of the paragraph handling code | 1516 | as 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 |
| 1518 | inconsistent behavior. | 1518 | inconsistent 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. | |||
| 1523 | This is a function that works like @code{indent-new-comment-line} in | 1523 | This is a function that works like @code{indent-new-comment-line} in |
| 1524 | comments and @code{newline-and-indent} elsewhere, thus combining those | 1524 | comments and @code{newline-and-indent} elsewhere, thus combining those |
| 1525 | two in a way that uses each one in the context it's best suited for. | 1525 | two in a way that uses each one in the context it's best suited for. |
| 1526 | I.e. in comments the comment line prefix and indentation is kept for | 1526 | I.e., in comments the comment line prefix and indentation is kept for |
| 1527 | the new line, and in normal code it's indented according to context by | 1527 | the new line, and in normal code it's indented according to context by |
| 1528 | the indentation engine. | 1528 | the 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-) |
| 1542 | This is to @kbd{C-o} (@kbd{M-x open-line}) as | 1542 | This 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 |
| 1545 | line break. | 1545 | line break. |
| 1546 | @end table | 1546 | @end table |
| @@ -1555,13 +1555,13 @@ line break. | |||
| 1555 | @comment !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! | 1555 | @comment !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! |
| 1556 | 1556 | ||
| 1557 | Preprocessor directives are handled as syntactic whitespace from other | 1557 | Preprocessor directives are handled as syntactic whitespace from other |
| 1558 | code, i.e. they can be interspersed anywhere without affecting the | 1558 | code, i.e., they can be interspersed anywhere without affecting the |
| 1559 | syntactic analysis, just like comments. | 1559 | syntactic analysis, just like comments. |
| 1560 | 1560 | ||
| 1561 | The code inside macro definitions is still analyzed syntactically so | 1561 | The code inside macro definitions is still analyzed syntactically so |
| 1562 | that you get relative indentation there just as you'd get if the same | 1562 | that you get relative indentation there just as you'd get if the same |
| 1563 | code was outside a macro. However, since there is no hint about the | 1563 | code was outside a macro. However, since there is no hint about the |
| 1564 | syntactic context, i.e. whether the macro expands to an expression, to some | 1564 | syntactic context, i.e., whether the macro expands to an expression, to some |
| 1565 | statements, or perhaps to whole functions, the syntactic recognition can be | 1565 | statements, or perhaps to whole functions, the syntactic recognition can be |
| 1566 | wrong. @ccmode{} manages to figure it out correctly most of the time, | 1566 | wrong. @ccmode{} manages to figure it out correctly most of the time, |
| 1567 | though. @xref{Syntactic Symbols}, for details about the indentation. | 1567 | though. @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 | |||
| 1601 | These variables control the alignment columns for line continuation | 1601 | These variables control the alignment columns for line continuation |
| 1602 | backslashes in multiline macros. They are used by the functions that | 1602 | backslashes in multiline macros. They are used by the functions that |
| 1603 | automatically insert or align such backslashes, | 1603 | automatically insert or align such backslashes, |
| 1604 | e.g. @code{c-backslash-region} and @code{c-context-line-break}. | 1604 | e.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 |
| 1607 | backslashes. If any line in the macro exceeds it then the next tab | 1607 | backslashes. 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-) |
| 1617 | Align automatically inserted line continuation backslashes if | 1617 | Align automatically inserted line continuation backslashes if |
| 1618 | non-@code{nil}. When line continuation backslashes are inserted | 1618 | non-@code{nil}. When line continuation backslashes are inserted |
| 1619 | automatically for line breaks in multiline macros, e.g. by | 1619 | automatically 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 |
| 1621 | in the same macro if this flag is set. Otherwise the inserted | 1621 | in the same macro if this flag is set. Otherwise the inserted |
| 1622 | backslashes are preceded by a single space. | 1622 | backslashes are preceded by a single space. |
| @@ -1738,7 +1738,7 @@ additional regexps to match those you use: | |||
| 1738 | For each language there's a variable @code{*-font-lock-extra-types}, | 1738 | For each language there's a variable @code{*-font-lock-extra-types}, |
| 1739 | where @samp{*} stands for the language in question. It contains a list | 1739 | where @samp{*} stands for the language in question. It contains a list |
| 1740 | of regexps that matches identifiers that should be recognized as types, | 1740 | of regexps that matches identifiers that should be recognized as types, |
| 1741 | e.g. @samp{\\sw+_t} to recognize all identifiers ending with @samp{_t} | 1741 | e.g., @samp{\\sw+_t} to recognize all identifiers ending with @samp{_t} |
| 1742 | as is customary in C code. Each regexp should not match more than a | 1742 | as is customary in C code. Each regexp should not match more than a |
| 1743 | single identifier. | 1743 | single 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 |
| 1837 | Preprocessor directives get @code{font-lock-preprocessor-face} if it | 1837 | Preprocessor directives get @code{font-lock-preprocessor-face} if it |
| 1838 | exists (i.e. XEmacs). In Emacs they get @code{font-lock-builtin-face} | 1838 | exists (i.e., XEmacs). In Emacs they get @code{font-lock-builtin-face} |
| 1839 | or @code{font-lock-reference-face}, for lack of a closer equivalent. | 1839 | or @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 | ||
| 1863 | There are various tools to supply documentation in the source as | 1863 | There are various tools to supply documentation in the source as |
| 1864 | specially structured comments, e.g. the standard Javadoc tool in Java. | 1864 | specially 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 |
| 1866 | the special markup inside them. | 1866 | the 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-) |
| 1870 | This is a style variable that specifies which documentation comment | 1870 | This is a style variable that specifies which documentation comment |
| 1871 | style to recognize, e.g. @code{javadoc} for Javadoc comments. | 1871 | style to recognize, e.g., @code{javadoc} for Javadoc comments. |
| 1872 | 1872 | ||
| 1873 | The value may also be a list of styles, in which case all of them are | 1873 | The value may also be a list of styles, in which case all of them are |
| 1874 | recognized simultaneously (presumably with markup cues that don't | 1874 | recognized simultaneously (presumably with markup cues that don't |
| @@ -1883,7 +1883,7 @@ and its value is used instead. | |||
| 1883 | Note that @ccmode{} uses this variable to set other variables that | 1883 | Note that @ccmode{} uses this variable to set other variables that |
| 1884 | handle fontification etc. That's done at mode initialization or when | 1884 | handle fontification etc. That's done at mode initialization or when |
| 1885 | you switch to a style which sets this variable. Thus, if you change it | 1885 | you switch to a style which sets this variable. Thus, if you change it |
| 1886 | in some other way, e.g. interactively in a CC Mode buffer, you will need | 1886 | in some other way, e.g., interactively in a CC Mode buffer, you will need |
| 1887 | to do @kbd{M-x java-mode} (or whatever mode you're currently using) to | 1887 | to do @kbd{M-x java-mode} (or whatever mode you're currently using) to |
| 1888 | reinitialize. | 1888 | reinitialize. |
| 1889 | 1889 | ||
| @@ -1993,7 +1993,7 @@ Indents the entire top-level function, class or macro definition | |||
| 1993 | encompassing point. It leaves point unchanged. This function can't be | 1993 | encompassing point. It leaves point unchanged. This function can't be |
| 1994 | used to reindent a nested brace construct, such as a nested class or | 1994 | used to reindent a nested brace construct, such as a nested class or |
| 1995 | function, or a Java method. The top-level construct being reindented | 1995 | function, or a Java method. The top-level construct being reindented |
| 1996 | must be complete, i.e. it must have both a beginning brace and an ending | 1996 | must be complete, i.e., it must have both a beginning brace and an ending |
| 1997 | brace. | 1997 | brace. |
| 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. | |||
| 2239 | A popular programming style, especially for object-oriented languages | 2239 | A popular programming style, especially for object-oriented languages |
| 2240 | such as C++ is to write symbols in a mixed case format, where the first | 2240 | such as C++ is to write symbols in a mixed case format, where the first |
| 2241 | letter of each word is capitalized, and not separated by underscores. | 2241 | letter of each word is capitalized, and not separated by underscores. |
| 2242 | E.g. @samp{SymbolsWithMixedCaseAndNoUnderlines}. | 2242 | e.g., @samp{SymbolsWithMixedCaseAndNoUnderlines}. |
| 2243 | 2243 | ||
| 2244 | This command moves point forward to next capitalized word. With prefix | 2244 | This command moves point forward to next capitalized word. With prefix |
| 2245 | argument @var{n}, move @var{n} times. | 2245 | argument @var{n}, move @var{n} times. |
| @@ -2295,7 +2295,7 @@ styles. | |||
| 2295 | Only syntactic symbols not already bound on @code{c-offsets-alist} will | 2295 | Only syntactic symbols not already bound on @code{c-offsets-alist} will |
| 2296 | be set from styles. This means that any association you set on it, be | 2296 | be set from styles. This means that any association you set on it, be |
| 2297 | it before or after mode initialization, will not be changed. The | 2297 | it 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 |
| 2299 | Customization interface@footnote{Available in Emacs 20 and later, and | 2299 | Customization interface@footnote{Available in Emacs 20 and later, and |
| 2300 | XEmacs 19.15 and later.} to easily change indentation offsets without | 2300 | XEmacs 19.15 and later.} to easily change indentation offsets without |
| 2301 | having to bother about styles. Initially @code{c-offsets-alist} is | 2301 | having to bother about styles. Initially @code{c-offsets-alist} is |
| @@ -2563,7 +2563,7 @@ this manual does not cover how that works. | |||
| 2563 | 2563 | ||
| 2564 | Variables set like this at the top level in @file{.emacs} take effect in | 2564 | Variables set like this at the top level in @file{.emacs} take effect in |
| 2565 | all @ccmode{} buffers, regardless of language. The indentation style | 2565 | all @ccmode{} buffers, regardless of language. The indentation style |
| 2566 | related variables, e.g. @code{c-offsets-alist}, that you don't set this | 2566 | related variables, e.g., @code{c-offsets-alist}, that you don't set this |
| 2567 | way get their value from the style system (@pxref{Styles}), and they | 2567 | way get their value from the style system (@pxref{Styles}), and they |
| 2568 | therefore depend on the setting of @code{c-default-style}. Note that if | 2568 | therefore depend on the setting of @code{c-default-style}. Note that if |
| 2569 | you use Customize, this means that the greyed-out default values | 2569 | you 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 | |||
| 2571 | values depend on the style, which may very well be different for | 2571 | values depend on the style, which may very well be different for |
| 2572 | different languages. | 2572 | different languages. |
| 2573 | 2573 | ||
| 2574 | If you want to make more advanced configurations, e.g. language-specific | 2574 | If you want to make more advanced configurations, e.g., language-specific |
| 2575 | customization, setting global variables isn't enough. For that you can | 2575 | customization, setting global variables isn't enough. For that you can |
| 2576 | use the language hooks, see @ref{Hooks}, and/or the style system, see | 2576 | use 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 | |||
| 2940 | automatically institute these offsets using @code{c-set-offset}. | 2940 | automatically institute these offsets using @code{c-set-offset}. |
| 2941 | @end defvar | 2941 | @end defvar |
| 2942 | 2942 | ||
| 2943 | Note that file style settings (i.e. @code{c-file-style}) are applied | 2943 | Note that file style settings (i.e., @code{c-file-style}) are applied |
| 2944 | before file offset settings (i.e. @code{c-file-offsets}). Also, if | 2944 | before file offset settings (i.e., @code{c-file-offsets}). Also, if |
| 2945 | either of these are set in a file's local variable section, all the | 2945 | either of these are set in a file's local variable section, all the |
| 2946 | style variable values are made local to that buffer. | 2946 | style variable values are made local to that buffer. |
| 2947 | 2947 | ||
| @@ -3086,7 +3086,7 @@ These @var{action} functions are called with two arguments: the | |||
| 3086 | syntactic symbol for the brace, and the buffer position at which the | 3086 | syntactic symbol for the brace, and the buffer position at which the |
| 3087 | brace was inserted. The @var{action} function is expected to return a | 3087 | brace was inserted. The @var{action} function is expected to return a |
| 3088 | list containing some combination of @code{before} and @code{after}, | 3088 | list containing some combination of @code{before} and @code{after}, |
| 3089 | including neither of them (i.e. @code{nil}). This return value has the | 3089 | including neither of them (i.e., @code{nil}). This return value has the |
| 3090 | normal brace hanging semantics. | 3090 | normal brace hanging semantics. |
| 3091 | 3091 | ||
| 3092 | As an example, @ccmode{} itself uses this feature to dynamically | 3092 | As 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. | |||
| 3181 | If every function in the list is called without a determination being | 3181 | If every function in the list is called without a determination being |
| 3182 | made, then no newline is added. The default value for this variable is a | 3182 | made, then no newline is added. The default value for this variable is a |
| 3183 | list containing a single function which inserts newlines only after | 3183 | list containing a single function which inserts newlines only after |
| 3184 | semicolons which do not appear inside parenthesis lists (i.e. those | 3184 | semicolons which do not appear inside parenthesis lists (i.e., those |
| 3185 | that separate @code{for}-clause statements). | 3185 | that 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 |
| 3217 | newlines after semicolons inside one-line inline method definitions | 3217 | newlines 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 | |||
| 3242 | indentation or line adjustments your style dictates, such as adding | 3242 | indentation or line adjustments your style dictates, such as adding |
| 3243 | extra indentation to constructors or destructor declarations in a | 3243 | extra indentation to constructors or destructor declarations in a |
| 3244 | class definition, etc. Note that you should not change point or mark | 3244 | class definition, etc. Note that you should not change point or mark |
| 3245 | inside your @code{c-special-indent-hook} functions, i.e. you'll | 3245 | inside your @code{c-special-indent-hook} functions, i.e., you'll |
| 3246 | probably want to wrap your function in a @code{save-excursion}. | 3246 | probably want to wrap your function in a @code{save-excursion}. |
| 3247 | 3247 | ||
| 3248 | Setting @code{c-special-indent-hook} in your style definition is | 3248 | Setting @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 |
| 3389 | Lines continuing an Objective-C method call. | 3389 | Lines continuing an Objective-C method call. |
| 3390 | @item extern-lang-open | 3390 | @item extern-lang-open |
| 3391 | Brace that opens an @code{extern} block (e.g. @code{extern "C" @{...@}}). | 3391 | Brace that opens an @code{extern} block (e.g., @code{extern "C" @{...@}}). |
| 3392 | @item extern-lang-close | 3392 | @item extern-lang-close |
| 3393 | Brace that closes an @code{extern} block. | 3393 | Brace 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. | |||
| 3411 | C++ template argument list continuations. | 3411 | C++ template argument list continuations. |
| 3412 | @item inlambda | 3412 | @item inlambda |
| 3413 | Analogous to @code{inclass} syntactic symbol, but used inside lambda | 3413 | Analogous 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 |
| 3416 | Lines continuing the header of a lambda function, i.e. between the | 3416 | Lines 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 |
| 3419 | A statement block inside an expression. The gcc C extension of this is | 3419 | A 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 | |||
| 3468 | the brace that opens a top-level function definition. Line 9 is the | 3468 | the brace that opens a top-level function definition. Line 9 is the |
| 3469 | corresponding | 3469 | corresponding |
| 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 |
| 3471 | function definition. Line 4 is a @code{defun-block-intro}, i.e. it is | 3471 | function definition. Line 4 is a @code{defun-block-intro}, i.e., it is |
| 3472 | the first line of a brace-block, enclosed in a | 3472 | the first line of a brace-block, enclosed in a |
| 3473 | top-level function definition. | 3473 | top-level function definition. |
| 3474 | 3474 | ||
| @@ -3793,7 +3793,7 @@ where @code{inextern-lang} is a modifier similar in purpose to | |||
| 3793 | 3793 | ||
| 3794 | There are various other top level blocks like @code{extern}, and they | 3794 | There are various other top level blocks like @code{extern}, and they |
| 3795 | are all treated in the same way except that the symbols are named after | 3795 | are all treated in the same way except that the symbols are named after |
| 3796 | the keyword that introduces the block. E.g. C++ namespace blocks get | 3796 | the keyword that introduces the block. e.g., C++ namespace blocks get |
| 3797 | the three symbols @code{namespace-open}, @code{namespace-close} and | 3797 | the 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 |
| 3952 | Multiline preprocessor macro definitions are normally handled just like | 3952 | Multiline preprocessor macro definitions are normally handled just like |
| 3953 | other code, i.e. the lines inside them are indented according to the | 3953 | other code, i.e., the lines inside them are indented according to the |
| 3954 | syntactic analysis of the preceding lines inside the macro. The first | 3954 | syntactic analysis of the preceding lines inside the macro. The first |
| 3955 | line inside a macro definition (i.e. the line after the starting line of | 3955 | line inside a macro definition (i.e., the line after the starting line of |
| 3956 | the cpp directive itself) gets @code{cpp-define-intro}. In this example: | 3956 | the 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 | |||
| 3968 | of a cpp directive is always given that symbol. Line 2 is given | 3968 | of 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 |
| 3970 | some extra indentation. Lines 3 through 5 are then analyzed as normal | 3970 | some extra indentation. Lines 3 through 5 are then analyzed as normal |
| 3971 | code, i.e. @code{substatement} on lines 3 and 4, and @code{else-clause} | 3971 | code, i.e., @code{substatement} on lines 3 and 4, and @code{else-clause} |
| 3972 | on line 5. | 3972 | on line 5. |
| 3973 | 3973 | ||
| 3974 | The syntactic analysis inside macros can be turned off with | 3974 | The 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 | ||
| 4095 | Here, line 2 is the first line in an argument declaration list and so is | 4095 | Here, line 2 is the first line in an argument declaration list and so is |
| 4096 | given the @code{knr-argdecl-intro} syntactic symbol. Subsequent lines | 4096 | given 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} |
| 4098 | syntax. | 4098 | syntax. |
| 4099 | 4099 | ||
| 4100 | 4100 | ||
| @@ -4322,7 +4322,7 @@ if ( x < 10 | |||
| 4322 | 4322 | ||
| 4323 | Since this function doesn't do anything for lines without an infix | 4323 | Since this function doesn't do anything for lines without an infix |
| 4324 | operator you typically want to use it together with some other lineup | 4324 | operator you typically want to use it together with some other lineup |
| 4325 | settings, e.g. as follows (the @code{arglist-close} setting is just a | 4325 | settings, e.g., as follows (the @code{arglist-close} setting is just a |
| 4326 | suggestion to get a consistent style): | 4326 | suggestion 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 | ||
| 4385 | The style variable @code{c-comment-prefix-regexp} is used to recognize | 4385 | The style variable @code{c-comment-prefix-regexp} is used to recognize |
| 4386 | the comment line prefix, e.g. the @samp{*} that usually starts every | 4386 | the comment line prefix, e.g., the @samp{*} that usually starts every |
| 4387 | line inside a comment. | 4387 | line 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 | ||
| 4513 | If @code{c-syntactic-indentation-in-macros} is non-@code{nil}, the | 4513 | If @code{c-syntactic-indentation-in-macros} is non-@code{nil}, the |
| 4514 | function returns the relative indentation to the macro start line to | 4514 | function returns the relative indentation to the macro start line to |
| 4515 | allow accumulation with other offsets. E.g. in the following cases, | 4515 | allow 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 |
| 4518 | on the @samp{#define} line: | 4518 | on 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-) |
| 4613 | This can be used with the in-expression block symbols to indent the | 4613 | This can be used with the in-expression block symbols to indent the |
| 4614 | whole block to the column where the construct is started. E.g. for Java | 4614 | whole block to the column where the construct is started. e.g., for Java |
| 4615 | anonymous classes, this lines up the class under the @samp{new} keyword, | 4615 | anonymous classes, this lines up the class under the @samp{new} keyword, |
| 4616 | and in Pike it lines up the lambda function body under the @samp{lambda} | 4616 | and in Pike it lines up the lambda function body under the @samp{lambda} |
| 4617 | keyword. Returns @code{nil} if the block isn't part of such a | 4617 | keyword. 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-) |
| 4831 | Line up C++ stream operators (i.e. @samp{<<} and @samp{>>}). | 4831 | Line 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, |
| 4959 | e.g. @code{inclass} and @code{inextern-lang}. | 4959 | e.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 | |||
| 5050 | work on AWK ``defuns''. | 5050 | work on AWK ``defuns''. |
| 5051 | 5051 | ||
| 5052 | Since there is no preprocessor in AWK, the commands which move to | 5052 | Since there is no preprocessor in AWK, the commands which move to |
| 5053 | preprocessor directives (e.g. @code{c-up-conditional}) are meaningless | 5053 | preprocessor directives (e.g., @code{c-up-conditional}) are meaningless |
| 5054 | in AWK mode and are not bound in the AWK mode keymap. | 5054 | in 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 | ||
| 5231 | The default is to set @code{require-final-newline} to @code{t} in the | 5231 | The default is to set @code{require-final-newline} to @code{t} in the |
| 5232 | languages that mandates that source files should end with newlines, | 5232 | languages that mandates that source files should end with newlines, |
| 5233 | i.e. C, C++ and Objective-C. | 5233 | i.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 | |||
| 5271 | section gives some insight in how @ccmode{} operates, how that interacts | 5271 | section gives some insight in how @ccmode{} operates, how that interacts |
| 5272 | with some coding styles, and what you can use to improve performance. | 5272 | with some coding styles, and what you can use to improve performance. |
| 5273 | 5273 | ||
| 5274 | The overall goal is that @ccmode{} shouldn't be overly slow (i.e. take | 5274 | The overall goal is that @ccmode{} shouldn't be overly slow (i.e., take |
| 5275 | more than a fraction of a second) in any interactive operation. | 5275 | more than a fraction of a second) in any interactive operation. |
| 5276 | I.e. it's tuned to limit the maximum response time in single operations, | 5276 | i.e., it's tuned to limit the maximum response time in single operations, |
| 5277 | which sometimes is at the expense of batch-like operations like | 5277 | which sometimes is at the expense of batch-like operations like |
| 5278 | reindenting whole blocks. If you find that @ccmode{} gradually gets | 5278 | reindenting whole blocks. If you find that @ccmode{} gradually gets |
| 5279 | slower and slower in certain situations, perhaps as the file grows in | 5279 | slower 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 |
| 5294 | One of the simplest things you can do to reduce scan time, is make sure | 5294 | One of the simplest things you can do to reduce scan time, is make sure |
| 5295 | any brace that opens a top-level construct@footnote{E.g. a function in | 5295 | any brace that opens a top-level construct@footnote{e.g., a function in |
| 5296 | C, or outermost class definition in C++ or Java.} always appears in the | 5296 | C, or outermost class definition in C++ or Java.} always appears in the |
| 5297 | leftmost column. This is actually an Emacs constraint, as embodied in | 5297 | leftmost column. This is actually an Emacs constraint, as embodied in |
| 5298 | the @code{beginning-of-defun} function which @ccmode{} uses heavily. If | 5298 | the @code{beginning-of-defun} function which @ccmode{} uses heavily. If |
| @@ -5334,7 +5334,7 @@ XEmacs users can set the variable | |||
| 5334 | tells @ccmode{} to use XEmacs-specific built-in functions which, in some | 5334 | tells @ccmode{} to use XEmacs-specific built-in functions which, in some |
| 5335 | circumstances, can locate the top-most opening brace much more quickly than | 5335 | circumstances, 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 |
| 5337 | styles where these braces are hung (e.g. most JDK-derived Java styles), | 5337 | styles where these braces are hung (e.g., most JDK-derived Java styles), |
| 5338 | this hack can improve performance of the core syntax parsing routines | 5338 | this hack can improve performance of the core syntax parsing routines |
| 5339 | from 3 to 60 times. However, for styles which @emph{do} conform to | 5339 | from 3 to 60 times. However, for styles which @emph{do} conform to |
| 5340 | Emacs' recommended style of putting top-level braces in column zero, | 5340 | Emacs' 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 | |||
| 5345 | 21.3 as of this writing in May 2003). | 5345 | 21.3 as of this writing in May 2003). |
| 5346 | 5346 | ||
| 5347 | Text properties are used to speed up skipping over syntactic whitespace, | 5347 | Text properties are used to speed up skipping over syntactic whitespace, |
| 5348 | i.e. comments and preprocessor directives. Indenting a line after a | 5348 | i.e., comments and preprocessor directives. Indenting a line after a |
| 5349 | huge macro definition can be slow the first time, but after that the | 5349 | huge macro definition can be slow the first time, but after that the |
| 5350 | text properties are in place and it should be fast (even after you've | 5350 | text properties are in place and it should be fast (even after you've |
| 5351 | edited other parts of the file and then moved back). | 5351 | edited other parts of the file and then moved back). |
| @@ -5353,7 +5353,7 @@ edited other parts of the file and then moved back). | |||
| 5353 | Font locking can be a CPU hog, especially the font locking done on | 5353 | Font locking can be a CPU hog, especially the font locking done on |
| 5354 | decoration level 3 which tries to be very accurate. Note that that | 5354 | decoration level 3 which tries to be very accurate. Note that that |
| 5355 | level is designed to be used with a font lock support mode that only | 5355 | level is designed to be used with a font lock support mode that only |
| 5356 | fontifies the text that's actually shown, i.e. Lazy Lock or Just-in-time | 5356 | fontifies the text that's actually shown, i.e., Lazy Lock or Just-in-time |
| 5357 | Lock mode, so make sure you use one of them. Fontification of a whole | 5357 | Lock mode, so make sure you use one of them. Fontification of a whole |
| 5358 | buffer with some thousand lines can often take over a minute. That is | 5358 | buffer with some thousand lines can often take over a minute. That is |
| 5359 | a known weakness; the idea is that it never should happen. | 5359 | a 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 | |||
| 5386 | intention to change this goal. | 5386 | intention to change this goal. |
| 5387 | 5387 | ||
| 5388 | If you want to reformat old code, you're probably better off using some | 5388 | If you want to reformat old code, you're probably better off using some |
| 5389 | other tool instead, e.g. @ref{Top, , GNU indent, indent, The `indent' | 5389 | other tool instead, e.g., @ref{Top, , GNU indent, indent, The `indent' |
| 5390 | Manual}, which has more powerful reformatting capabilities than | 5390 | Manual}, 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 | |||
| 5526 | you think it might affect our ability to reproduce it. | 5526 | you think it might affect our ability to reproduce it. |
| 5527 | 5527 | ||
| 5528 | Please try to produce the problem in an Emacs instance without any | 5528 | Please try to produce the problem in an Emacs instance without any |
| 5529 | customizations loaded (i.e. start it with the @code{-q -no-site-file} | 5529 | customizations loaded (i.e., start it with the @samp{-q --no-site-file} |
| 5530 | arguments). If it works correctly there, the problem might be caused by | 5530 | arguments). If it works correctly there, the problem might be caused by |
| 5531 | faulty customizations in either your own or your site configuration. In | 5531 | faulty customizations in either your own or your site configuration. In |
| 5532 | that case, we'd appreciate if you isolate the Emacs Lisp code that trigs | 5532 | that case, we'd appreciate if you isolate the Emacs Lisp code that trigs |