Misc

Lets you control miscellaneous comment options.

Keep first column comments as-is

When enabled, first column comments are never formatted and/or wrapped. First column comments are often used for commenting out blocks of code during development and formatting/wrapping might severely come into the way here.

Since 1.6

Example 2.749. Wrapped first column comment

// System.out.println("appendingRemainingName: " + name.toString()); Exception 
// e = new Exception(); e.printStackTrace();

Example 2.750. Untouched first column comment

// System.out.println("appendingRemainingName: " + name.toString());
// Exception e = new Exception();
// e.printStackTrace();

Move comments after brace block

When enabled, single comments that appear in the first line after the left curly brace of a statement block and only cover one line are moved right after the brace. This way you can achieve a more dense layout in case you want to save vertical space.

Since 1.7

When enabled, the following code

Example 2.751. Comments after left curly braces

void test()
{
    /**
     * @todo evaluate whether this is still necessary
     */
    if (condition1)
    {
        // i should do something
        doSomething();
    }
    else if (condition2)
    {
        // [PENDING] this should be part of whatever, ask Jeff
        // what to do
        takeAction();
    }
}

would be printed as:

Example 2.752. Comments after left curly braces

void test()
{
    /**
     * @todo evaluate whether this is still necessary
     */
    if (condition1)
    { // i should do something
        doSomething();
    }
    else if (condition2)
    {
        // [PENDING] this should be part of whatever, ask Jeff
        // what to do
        takeAction();
    }
}

Please note how only the single comment within after the if statement is affected. The comment after the declaration block brace and the consecutive comments after the else statement, have been left alone.