Description Brian Pontarelli 2003-01-03 16:22:55 EST

The JDT is lacking any continuation indent support which is not only part of 
the Sun Java coding standards, but also very common in most editors. 
Continuation indent is the indentation of statements that span multiple lines. 
This normally means when a carriage return is encountered and the last non-
whitespace character in the buffer (model, whatever is storing the text) is not 
a '{' or ';' character. Most commonly, statements are broken directly after 
the '=', ';', ')', '.' or ',' characters, after or before 
the '||', '&&', '|', '&' or '!' operators, after or before keywords 
like 'extends', 'throws', 'implements', etc.

I'll use a notation where I show a snippet of code labeled before and a snippet 
of code labeled after. The before code is roughly what a long statement would 
look like. The after code is what the statement should look like after the 
developer breaks the statement to multiple lines and continuation indentation 
has taken place. For most examples, I'll provide one example with the before 
statement broken into two lines and second example witht eh before statement 
broken into three lines.

Normally, continuation indent has multiple settings. These are something like 
this:

Continuation indent to current indent level
-------------------------------------------
before->
myMethod() {
    someClass.someMethod(variable1, variable2, "literal1", "literal2");
}

after->
myMethod() {
    someClass.someMethod(variable1, variable2, "literal1", 
    "literal2");
}

after 2->
myMethod() {
    someClass.someMethod(variable1, variable2, 
    "literal1", 
    "literal2");
}


Continuation indent by current indent amount
--------------------------------------------
before->
myMethod() {
    someClass.someMethod(variable1, variable2, "literal1", "literal2");
}

after->
myMethod() {
    someClass.someMethod(variable1, variable2, "literal1", 
        "literal2");
}

after 2->
myMethod() {
    someClass.someMethod(variable1, variable2, 
        "literal1", 
        "literal2");
}


Continuation indent to current indent amount except deep indent methods
-----------------------------------------------------------------------
before->
myMethod() {
    someClass.someMethod(variable1, variable2, "literal1", "literal2");
}

after->
myMethod() {
    someClass.someMethod(variable1, variable2, "literal1", 
                         "literal2");
}

after 2->
myMethod() {
    someClass.someMethod(variable1, variable2, 
                         "literal1", 
                         "literal2");
}


Continuation indent to a specific amount (2 spaces)
---------------------------------------------------
before->
myMethod() {
    someClass.someMethod(variable1, variable2, "literal1", "literal2");
}

after->
myMethod() {
    someClass.someMethod(variable1, variable2, "literal1", 
      "literal2");
}

after 2->
myMethod() {
    someClass.someMethod(variable1, variable2, 
      "literal1", 
      "literal2");
}


Continuation indent based on parenthesis
----------------------------------------
before->
myMethod() {
    someClass.someMethod(someLocalMethod(variable1, "literal1"), "literal2");
}

after->
myMethod() {
    someClass.someMethod(someLocalMethod(variable1, "literal1"), 
        "literal2");
}

after 2->
myMethod() {
    someClass.someMethod(
        someLocalMethod(variable1, 
            "literal1"), "literal2");
}


Select continuation indent by keyword (here the throws keyword is not 
continuation indented)
----------------------------------------------------------------------
before->
myMethod(String param1, String param2) throws MyException {
    someLocalMethod();
}

after->
myMethod(String param1, String param2) 
throws MyException {
    someLocalMethod();
}

after 2->
myMethod(String param1, 
    String param2) 
throws MyException {
    someLocalMethod();
}


Continuation indent double on method parameters and if statements (this follows 
Sun's coding standards)
-------------------------------------------------------------------------------
before->
myMethod(String param1, String param2) throws MyException {
    someLocalMethod();
}

after->
myMethod(String param1, 
        String param2) throws MyException {
    someLocalMethod();
}

another before->
myMethod(String param1, String param2) throws MyException {
    if (param1.equals("1") && param2.equals("2")) {
        someLocalMethod(param1, param2);
    }
}

another after->
myMethod(String param1, String param2) throws MyException {
    if (param1.equals("1") && 
            param2.equals("2")) {
        someLocalMethod(param1, param2);
    }
}