comparison man/cc-mode.texi @ 59996:aac0a33f5772

Change release version from 21.4 to 22.1 throughout. Change development version from 21.3.50 to 22.0.50.

59995:8f4938738427

@comment %**end of header (This is for running Texinfo on a region)
@comment !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!


@comment !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
@comment 
@comment Texinfo manual for CC Mode
@comment Generated from the original README file by Krishna Padmasola
@comment <[e-mail]>
@comment
@comment Authors:
@comment Barry A. Warsaw
@comment Martin Stjernholm
@comment
@comment Maintained by Martin Stjernholm <[e-mail]>
@comment 
@comment !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!

@comment Define an index for syntactic symbols.
@defindex ss

@comment node-name, next, previous,up
@section Indentation Commands
@comment !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!

The following list of commands reindent C constructs.  Note that when
you change your coding style, either interactively or through some other 
means, your file does @emph{not} automatically get reindented.  You
will need to execute one of the following commands to see the effects of 
your changes.

@cindex GNU indent program
Also, variables like @code{c-hanging-*} and @code{c-cleanup-list}
only affect how on-the-fly code is formatted.  Changing the

@item
If @samp{other} is not found then the @samp{gnu} style is used.

@item
In all cases, the style described in @code{c-default-style} is installed 
@emph{before} the language hooks are run, so you can always override
this setting by including an explicit call to @code{c-set-style} in your 
language mode hook, or in @code{c-mode-common-hook}.
@end enumerate
@end defopt

@defvar c-indentation-style

with a @code{c-basic-offset} of 2, you can see that lines 4 through 6
are simply indented two spaces to the right of line 3.  But perhaps we'd
like @ccmode{} to be a little more intelligent so that it aligns
all the @samp{<<} symbols in lines 3 through 6.  To do this, we have
to write a custom indentation function which finds the column of the first
stream operator on the first line of the statement.  Here is sample 
lisp code implementing this:

@example
(defun c-lineup-streamop (langelem)
  (save-excursion

calls.  This example illustrates these:

@example
 1: void a_function( int line1,
 2:                  int line2 );
 3: 
 4: void a_longer_function(
 5:     int line1,
 6:     int line2
 7:     );
 8: 
 9: void call_them( int line1, int line2 )
10: @{
11:     a_function(
12:         line1,
13:         line2
14:         );
15: 
16:     a_longer_function( line1,
17:                        line2 );
18: @}
@end example

 1: void Bass::play( int volume )
 2: const
 3: @{
 4:     /* this line starts a multiline
 5:      * comment.  This line should get `c' syntax */
 6: 
 7:     char* a_multiline_string = "This line starts a multiline \
 8: string.  This line should get `string' syntax.";
 9: 
10:   note:
11:     @{
12: #ifdef LOCK
13:         Lock acquire();
14: #endif // LOCK

Indent a multiline block @code{c-basic-offset} extra.  E.g:

@example
@group
int *foo[] = @{
    NULL,                 
    @{17@},             @hereFn{c-indent-multi-line-block}
@end group
@end example

@noindent

indentation is added.  E.g:

@example
@group
main (int,
      char **           
     )                @hereFn{c-lineup-close-paren}
@end group
@end example

@noindent

E.g:

@example
@group
class Foo
    extends           
        Bar           @hereFn{c-lineup-java-inher}
    @sssTBasicOffset{}
@end group
@end example

other top-level block constructs in the @ccmode{} languages).
@xref{Left Margin Paren,,, emacs, The Emacs Editor}, for details
(@xref{Defuns,,, emacs, The Emacs Editor}, in the Emacs 20 manual).

This heuristic is built into the core syntax analysis routines in
(X)Emacs, so it's not really a @ccmode{} issue.  However, in Emacs 21.4
it has become possible to turn it off@footnote{Using the variable
@code{open-paren-in-column-0-is-defun-start}.} and @ccmode{} does so
there since it got its own system to keep track of blocks.

@end itemize

59996:aac0a33f5772

@comment %**end of header (This is for running Texinfo on a region)
@comment !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!


@comment !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
@comment
@comment Texinfo manual for CC Mode
@comment Generated from the original README file by Krishna Padmasola
@comment <[e-mail]>
@comment
@comment Authors:
@comment Barry A. Warsaw
@comment Martin Stjernholm
@comment
@comment Maintained by Martin Stjernholm <[e-mail]>
@comment
@comment !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!

@comment Define an index for syntactic symbols.
@defindex ss

@comment node-name, next, previous,up
@section Indentation Commands
@comment !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!

The following list of commands reindent C constructs.  Note that when
you change your coding style, either interactively or through some other
means, your file does @emph{not} automatically get reindented.  You
will need to execute one of the following commands to see the effects of
your changes.

@cindex GNU indent program
Also, variables like @code{c-hanging-*} and @code{c-cleanup-list}
only affect how on-the-fly code is formatted.  Changing the

@item
If @samp{other} is not found then the @samp{gnu} style is used.

@item
In all cases, the style described in @code{c-default-style} is installed
@emph{before} the language hooks are run, so you can always override
this setting by including an explicit call to @code{c-set-style} in your
language mode hook, or in @code{c-mode-common-hook}.
@end enumerate
@end defopt

@defvar c-indentation-style

with a @code{c-basic-offset} of 2, you can see that lines 4 through 6
are simply indented two spaces to the right of line 3.  But perhaps we'd
like @ccmode{} to be a little more intelligent so that it aligns
all the @samp{<<} symbols in lines 3 through 6.  To do this, we have
to write a custom indentation function which finds the column of the first
stream operator on the first line of the statement.  Here is sample
lisp code implementing this:

@example
(defun c-lineup-streamop (langelem)
  (save-excursion

calls.  This example illustrates these:

@example
 1: void a_function( int line1,
 2:                  int line2 );
 3:
 4: void a_longer_function(
 5:     int line1,
 6:     int line2
 7:     );
 8:
 9: void call_them( int line1, int line2 )
10: @{
11:     a_function(
12:         line1,
13:         line2
14:         );
15:
16:     a_longer_function( line1,
17:                        line2 );
18: @}
@end example

 1: void Bass::play( int volume )
 2: const
 3: @{
 4:     /* this line starts a multiline
 5:      * comment.  This line should get `c' syntax */
 6:
 7:     char* a_multiline_string = "This line starts a multiline \
 8: string.  This line should get `string' syntax.";
 9:
10:   note:
11:     @{
12: #ifdef LOCK
13:         Lock acquire();
14: #endif // LOCK

Indent a multiline block @code{c-basic-offset} extra.  E.g:

@example
@group
int *foo[] = @{
    NULL,
    @{17@},             @hereFn{c-indent-multi-line-block}
@end group
@end example

@noindent

indentation is added.  E.g:

@example
@group
main (int,
      char **
     )                @hereFn{c-lineup-close-paren}
@end group
@end example

@noindent

E.g:

@example
@group
class Foo
    extends
        Bar           @hereFn{c-lineup-java-inher}
    @sssTBasicOffset{}
@end group
@end example

other top-level block constructs in the @ccmode{} languages).
@xref{Left Margin Paren,,, emacs, The Emacs Editor}, for details
(@xref{Defuns,,, emacs, The Emacs Editor}, in the Emacs 20 manual).

This heuristic is built into the core syntax analysis routines in
(X)Emacs, so it's not really a @ccmode{} issue.  However, in Emacs 22.1
it has become possible to turn it off@footnote{Using the variable
@code{open-paren-in-column-0-is-defun-start}.} and @ccmode{} does so
there since it got its own system to keep track of blocks.

@end itemize