comparison doc/misc/cc-mode.texi @ 109606:fa191ba50511

Enhance CC Mode manual to cover the new Java features.

109605:bdba5a231521

* Syntactic Symbols::
* Indentation Calculation::

Syntactic Symbols

* Function Symbols::
* Class Symbols::
* Conditional Construct Symbols::
* Switch Statement Symbols::
* Brace List Symbols::
* External Scope Symbols::
* Paren List Symbols::
* Literal Symbols::
* Multiline Macro Symbols::
* Objective-C Method Symbols::
* Anonymous Class Symbol::
* Statement Block Symbols::
* K&R Symbols::

Customizing Indentation

* c-offsets-alist::
* Interactive Customization::

The first line in a ``topmost'' definition.  @ref{Function Symbols}.
@item topmost-intro-cont
Topmost definition continuation lines.  This is only used in the parts
that aren't covered by other symbols such as @code{func-decl-cont} and
@code{knr-argdecl}.  @ref{Function Symbols}.
@item member-init-intro
First line in a member initialization list.  @ref{Class Symbols}.
@item member-init-cont
Subsequent member initialization list lines.  @ref{Class Symbols}.
@item inher-intro

with an open brace.  @ref{Brace List Symbols}.
@item statement
A statement.  @ref{Function Symbols}.
@item statement-cont
A continuation of a statement.  @ref{Function Symbols}.
@item statement-block-intro
The first line in a new statement block.  @ref{Conditional Construct
Symbols}.
@item statement-case-intro
The first line in a case block.  @ref{Switch Statement Symbols}.

take a statement block as an argument in Pike.  @ref{Statement Block
Symbols}.
@item inexpr-class
A class definition inside an expression.  This is used for anonymous
classes in Java.  It's also used for anonymous array initializers in
Java.  @ref{Anonymous Class Symbol}.
@end table

@menu
* Function Symbols::
* Class Symbols::
* Conditional Construct Symbols::
* Switch Statement Symbols::
* Brace List Symbols::
* External Scope Symbols::
* Paren List Symbols::
* Literal Symbols::
* Multiline Macro Symbols::
* Objective-C Method Symbols::
* Anonymous Class Symbol::
* Statement Block Symbols::
* K&R Symbols::
@end menu

@comment !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
@node    Function Symbols, Class Symbols, Syntactic Symbols, Syntactic Symbols
@comment node-name, next, previous, up

((inclass 58) (access-label 58))
@end example

@noindent
The primary syntactic symbol for this line is @code{access-label} as
this a label keyword that specifies access protection in C++.  However,
because this line is also a top-level construct inside a class
definition, the analysis actually shows two syntactic symbols.  The
other syntactic symbol assigned to this line is @code{inclass}.
Similarly, line 6 is given both @code{inclass} and @code{topmost-intro}
syntax:

macros.}.

@xref{Custom Macros}, for more info about the treatment of macros.

@comment !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
@node    Objective-C Method Symbols, Anonymous Class Symbol, Multiline Macro Symbols, Syntactic Symbols
@comment node-name, next, previous, up
@subsection Objective-C Method Symbols
@comment !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!

In Objective-C buffers, there are three additional syntactic symbols

Here, line 1 is assigned @code{objc-method-intro} syntax, and line 2 is
assigned @code{objc-method-args-cont} syntax.  Lines 5 and 6 are both
assigned @code{objc-method-call-cont} syntax.

@comment !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
@node    Anonymous Class Symbol, Statement Block Symbols, Objective-C Method Symbols, Syntactic Symbols
@comment node-name, next, previous, up
@subsection Anonymous Class Symbol (Java)
@comment !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!

Java has a concept of anonymous classes which can look something like
this:

@example
 1: public void watch(Observable o) @{
 2:     o.addObserver(new Observer() @{
 3:             public void update(Observable o, Object arg) @{
 4:                 history.addElement(arg);
 5:             @}
 6:         @});
 7: @}
@end example

@ssindex inexpr-class
The brace following the @code{new} operator opens the anonymous class.
Lines 3 and 6 are assigned the @code{inexpr-class} syntax, besides the
@code{inclass} symbol used in normal classes.  Thus, the class will be
indented just like a normal class, with the added indentation given to
@code{inexpr-class}.  An @code{inexpr-class} syntactic element doesn't
have an anchor position.

@comment !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
@node    Statement Block Symbols, K&R Symbols, Anonymous Class Symbol, Syntactic Symbols
@comment node-name, next, previous, up
@subsection Statement Block Symbols
@comment !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!

There are a few occasions where a statement block might be used inside

109606:fa191ba50511

* Syntactic Symbols::
* Indentation Calculation::

Syntactic Symbols

* Function Symbols::            
* Class Symbols::               
* Conditional Construct Symbols::  
* Switch Statement Symbols::    
* Brace List Symbols::          
* External Scope Symbols::      
* Paren List Symbols::          
* Literal Symbols::             
* Multiline Macro Symbols::     
* Objective-C Method Symbols::  
* Java Symbols::
* Statement Block Symbols::     
* K&R Symbols::                 

Customizing Indentation

* c-offsets-alist::
* Interactive Customization::

The first line in a ``topmost'' definition.  @ref{Function Symbols}.
@item topmost-intro-cont
Topmost definition continuation lines.  This is only used in the parts
that aren't covered by other symbols such as @code{func-decl-cont} and
@code{knr-argdecl}.  @ref{Function Symbols}.
@item annotation-top-cont
Topmost definition continuation lines where all previous items are
annotations.  @ref{Java Symbols}.
@item member-init-intro
First line in a member initialization list.  @ref{Class Symbols}.
@item member-init-cont
Subsequent member initialization list lines.  @ref{Class Symbols}.
@item inher-intro

with an open brace.  @ref{Brace List Symbols}.
@item statement
A statement.  @ref{Function Symbols}.
@item statement-cont
A continuation of a statement.  @ref{Function Symbols}.
@item annotation-var-cont
A continuation of a statement where all previous items are
annotations.  @ref{Java Symbols}.
@item statement-block-intro
The first line in a new statement block.  @ref{Conditional Construct
Symbols}.
@item statement-case-intro
The first line in a case block.  @ref{Switch Statement Symbols}.

take a statement block as an argument in Pike.  @ref{Statement Block
Symbols}.
@item inexpr-class
A class definition inside an expression.  This is used for anonymous
classes in Java.  It's also used for anonymous array initializers in
Java.  @ref{Java Symbols}.
@end table

@menu
* Function Symbols::            
* Class Symbols::               
* Conditional Construct Symbols::  
* Switch Statement Symbols::    
* Brace List Symbols::          
* External Scope Symbols::      
* Paren List Symbols::          
* Literal Symbols::             
* Multiline Macro Symbols::     
* Objective-C Method Symbols::  
* Java Symbols::
* Statement Block Symbols::     
* K&R Symbols::                 
@end menu

@comment !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
@node    Function Symbols, Class Symbols, Syntactic Symbols, Syntactic Symbols
@comment node-name, next, previous, up

((inclass 58) (access-label 58))
@end example

@noindent
The primary syntactic symbol for this line is @code{access-label} as
this is a label keyword that specifies access protection in C++.  However,
because this line is also a top-level construct inside a class
definition, the analysis actually shows two syntactic symbols.  The
other syntactic symbol assigned to this line is @code{inclass}.
Similarly, line 6 is given both @code{inclass} and @code{topmost-intro}
syntax:

macros.}.

@xref{Custom Macros}, for more info about the treatment of macros.

@comment !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
@node    Objective-C Method Symbols, Java Symbols, Multiline Macro Symbols, Syntactic Symbols
@comment node-name, next, previous, up
@subsection Objective-C Method Symbols
@comment !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!

In Objective-C buffers, there are three additional syntactic symbols

Here, line 1 is assigned @code{objc-method-intro} syntax, and line 2 is
assigned @code{objc-method-args-cont} syntax.  Lines 5 and 6 are both
assigned @code{objc-method-call-cont} syntax.

@comment !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
@node    Java Symbols, Statement Block Symbols, Objective-C Method Symbols, Syntactic Symbols
@comment node-name, next, previous, up
@subsection Java Symbols
@comment !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!

Java has a concept of anonymous classes which can look something like
this:

@example
 1:  @@Test
 2:  public void watch(Observable o) @{
 3:      @@NonNull
 4:      Observer obs = new Observer() @{
 5:          public void update(Observable o, Object arg) @{
 6:              history.addElement(arg);
 7:          @}
 8:      @};
 9:      o.addObserver(obs);
 10: @}
@end example

@ssindex inexpr-class
The brace following the @code{new} operator opens the anonymous class.
Lines 5 and 8 are assigned the @code{inexpr-class} syntax, besides the
@code{inclass} symbol used in normal classes.  Thus, the class will be
indented just like a normal class, with the added indentation given to
@code{inexpr-class}.  An @code{inexpr-class} syntactic element doesn't
have an anchor position.

@ssindex annotation-top-cont
@ssindex annotation-var-cont
Line 2 is assigned the @code{annotation-top-cont} syntax, due to it being a
continuation of a topmost introduction with an annotation symbol preceding
the current line.  Similarly, line 4 is assigned the @code{annotation-var-cont}
syntax due to it being a continuation of a variable declaration where preceding
the declaration is an annotation.

@comment !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
@node    Statement Block Symbols, K&R Symbols, Java Symbols, Syntactic Symbols
@comment node-name, next, previous, up
@subsection Statement Block Symbols
@comment !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!

There are a few occasions where a statement block might be used inside