comparison man/cc-mode.texi @ 26490:2b08d829af86

Fix complaints from makeinfo 4.0.

26489:1a438767af51

@code{brace-list-intro}, @code{brace-list-entry}, @code{block-open},
@code{block-close}, @code{substatement-open}, 
@code{statement-case-open},
@code{extern-lang-open}, @code{extern-lang-close},
@code{namespace-open}, and @code{namespace-close}.
@xref{Syntactic Symbols} for a more
detailed description of these syntactic symbols.

@cindex Custom Indentation Functions
The value associated with each syntactic symbol in this association list
is called an @var{ACTION} which can be either a function or a list.
@xref{Custom Brace and Colon Hanging} for a more detailed discussion of
using a function as a brace hanging @var{ACTION}.

When the @var{ACTION} is a list, it can contain any combination of the
symbols @code{before} and @code{after}, directing @ccmode{} where to
put newlines in relationship to the brace being inserted.  Thus, if the

A word of caution: it is not a good idea to hang top-level construct
introducing braces, such as @code{class-open} or @code{defun-open}.
Emacs makes an assumption that such braces will always appear in column
zero, hanging such braces can introduce performance problems.
@xref{Performance Issues} for more information.


@comment !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
@node  Hanging Colons, Hanging Semi-colons and commas, Hanging Braces, Auto-newline insertion
@comment  node-name,              next,                    previous,up

@cindex Clean-ups
In C++, double-colons are used as a scope operator but because these
colons always appear right next to each other, newlines before and after
them are controlled by a different mechanism, called @dfn{clean-ups} in
@ccmode{}.  @xref{Clean-ups} for details.


@comment !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
@node  Hanging Semi-colons and commas, Other electric commands, Hanging Colons, Auto-newline insertion
@comment  node-name,              next,                    previous,up

Semicolons and commas are also electric in @ccmode{}, but since
these characters do not correspond directly to syntactic symbols, a
different mechanism is used to determine whether newlines should be
automatically inserted after these characters.  @xref{Customizing
Semi-colons and Commas} for details.


@comment !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
@node  Other electric commands, Clean-ups, Hanging Semi-colons and commas, Auto-newline insertion
@comment  node-name,              next,                    previous,up

@code{nil} to inhibit progress messages, including messages normally
printed when indentation is started and completed.

Also, except as noted below, re-indentation is always driven by the
same mechanisms that control on-the-fly indentation of code.  @xref{New
Indentation Engine} for details.

@findex c-indent-command
@findex indent-command (c-)
@vindex c-tab-always-indent
@vindex tab-always-indent (c-)

C-o} (@code{c-set-offset}) as the way to set offsets, both interactively
and from your mode hook.  Also, you can set up @emph{styles} of
indentatio.  Most likely, you'll
find one of the pre-defined styles will suit your needs, but if not,
this section will describe how to set up basic editing configurations.
@xref{Styles} for an explanation of how to set up named styles.

@cindex c-basic-offset
@cindex basic-offset (c-)
As mentioned previously, the variable @code{c-offsets-alist} is an
association list of syntactic symbols and the offsets to be applied for

Here's a simplified example of what you can add to your @file{.emacs}
file to make the changes described in the previous section
(@ref{Interactive Customization}) more permanent.  See the Emacs manuals
for more information on customizing Emacs via hooks.  @xref{Sample
.emacs File} for a more complete sample @file{.emacs} file.
@example
@group

(defun my-c-mode-common-hook ()
  ;; my customizations for all of c-mode and related modes

@code{user} --- This is a special style for several reasons.  First, if
you customize @ccmode{} by using either the new Custom interface or by
doing @code{setq}'s at the top level of your @file{.emacs} file, these
settings will be captured in the @code{user} style.  Also, all other
styles implicitly inherit their settings from @code{user} style.  This
means that for any styles you add via @code{c-add-style} (@xref{Adding
Styles}) you need only define the differences between your new style and
@code{user} style.

Note however that @code{user} style is @emph{not} the default style.
@code{gnu} is the default style for all newly created buffers, but you

26490:2b08d829af86

@code{brace-list-intro}, @code{brace-list-entry}, @code{block-open},
@code{block-close}, @code{substatement-open}, 
@code{statement-case-open},
@code{extern-lang-open}, @code{extern-lang-close},
@code{namespace-open}, and @code{namespace-close}.
@xref{Syntactic Symbols}, for a more
detailed description of these syntactic symbols.

@cindex Custom Indentation Functions
The value associated with each syntactic symbol in this association list
is called an @var{ACTION} which can be either a function or a list.
@xref{Custom Brace and Colon Hanging}, for a more detailed discussion of
using a function as a brace hanging @var{ACTION}.

When the @var{ACTION} is a list, it can contain any combination of the
symbols @code{before} and @code{after}, directing @ccmode{} where to
put newlines in relationship to the brace being inserted.  Thus, if the

A word of caution: it is not a good idea to hang top-level construct
introducing braces, such as @code{class-open} or @code{defun-open}.
Emacs makes an assumption that such braces will always appear in column
zero, hanging such braces can introduce performance problems.
@xref{Performance Issues}, for more information.


@comment !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
@node  Hanging Colons, Hanging Semi-colons and commas, Hanging Braces, Auto-newline insertion
@comment  node-name,              next,                    previous,up

@cindex Clean-ups
In C++, double-colons are used as a scope operator but because these
colons always appear right next to each other, newlines before and after
them are controlled by a different mechanism, called @dfn{clean-ups} in
@ccmode{}.  @xref{Clean-ups}, for details.


@comment !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
@node  Hanging Semi-colons and commas, Other electric commands, Hanging Colons, Auto-newline insertion
@comment  node-name,              next,                    previous,up

Semicolons and commas are also electric in @ccmode{}, but since
these characters do not correspond directly to syntactic symbols, a
different mechanism is used to determine whether newlines should be
automatically inserted after these characters.  @xref{Customizing
Semi-colons and Commas}, for details.


@comment !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
@node  Other electric commands, Clean-ups, Hanging Semi-colons and commas, Auto-newline insertion
@comment  node-name,              next,                    previous,up

@code{nil} to inhibit progress messages, including messages normally
printed when indentation is started and completed.

Also, except as noted below, re-indentation is always driven by the
same mechanisms that control on-the-fly indentation of code.  @xref{New
Indentation Engine}, for details.

@findex c-indent-command
@findex indent-command (c-)
@vindex c-tab-always-indent
@vindex tab-always-indent (c-)

C-o} (@code{c-set-offset}) as the way to set offsets, both interactively
and from your mode hook.  Also, you can set up @emph{styles} of
indentatio.  Most likely, you'll
find one of the pre-defined styles will suit your needs, but if not,
this section will describe how to set up basic editing configurations.
@xref{Styles}, for an explanation of how to set up named styles.

@cindex c-basic-offset
@cindex basic-offset (c-)
As mentioned previously, the variable @code{c-offsets-alist} is an
association list of syntactic symbols and the offsets to be applied for

Here's a simplified example of what you can add to your @file{.emacs}
file to make the changes described in the previous section
(@ref{Interactive Customization}) more permanent.  See the Emacs manuals
for more information on customizing Emacs via hooks.  @xref{Sample
.emacs File}, for a more complete sample @file{.emacs} file.
@example
@group

(defun my-c-mode-common-hook ()
  ;; my customizations for all of c-mode and related modes

@code{user} --- This is a special style for several reasons.  First, if
you customize @ccmode{} by using either the new Custom interface or by
doing @code{setq}'s at the top level of your @file{.emacs} file, these
settings will be captured in the @code{user} style.  Also, all other
styles implicitly inherit their settings from @code{user} style.  This
means that for any styles you add via @code{c-add-style} (@pxref{Adding
Styles}) you need only define the differences between your new style and
@code{user} style.

Note however that @code{user} style is @emph{not} the default style.
@code{gnu} is the default style for all newly created buffers, but you