4.3. Printer

+Lets you control all printer related settings. +

4.3.1. Braces

+Controls the handling of curly braces (the Java block delimeters). +

4.3.1.1. General

+Controls how the enclosing block delimeters - left and right curly +brace - are printed. You can either choose from a predefined set of common +styles or build one on your own. +

4.3.1.1.1. Styles

+Controls which brace style will be used to lay out blocks. +

+C style +
+Selects the C brace style. This style is sometimes called "Allman style" or "BSD style". +
Example 4.1. C style
+if (!isDone) +{ + doSomething(); +} +else +{ + System.err.println("Finished"); +} +
+Sun style +
+Selects the Sun brace style. Sometimes called "K&R style". +
Example 4.2. Sun style
+if (!isDone) { + doSomething(); +} else { + System.err.println("Finished"); +} +

+GNU style +

+Selects the GNU brace style. +

Example 4.3. GNU style

+if (!isDone)
+  {
+    doSomething();
+  }
+else
+  {
+    System.err.println("Finished");
+  }
+

+Custom style +
+Selecting this option will enable you to freely choose between the different brace +style options discussed below. +

4.3.1.1.2. Wrapping

+Controls the brace wrapping options. +

+Newline before left brace +
+If enabled, always prints a newline before the left curly brace. +
+Newline after right brace +
+If enabled, prints a newline after the left curly brace (when possible). +
+Treat class/method blocks different +
+It is common in the Java developer community to have the opening brace +at the end of the line of the keyword for all types of blocks (Sun brace style). +One may find the C++ convention of treating class/interface and method/constructor +blocks different from other blocks useful. With this switch you can achieve +exactly that: if enabled, class/interface and method/constructor blocks are +then always printed in C brace style (newline before left brace). +
+Treat class/method blocks different if wrapped +
+With this switch enabled, the opening brace for class/interface or +method/constructor blocks will always be printed on a new line (C style), if +either the parameter list spawns several lines and a throws +clause follows, or one of the possible clauses (extends, +implements, throws) was wrapped. +

4.3.1.1.3. Whitespace

+Controls the indentation whitespace for the left and right curly brace. +

+Before left brace +
+Number of spaces to print before the left curly brace. +
+After left brace +
+Number of spaces to print after the left curly brace. +
+After right brace +
+Number of spaces to print after the right curly brace. +

4.3.1.2. Misc

+Controls miscellaneous brace options. +

4.3.1.2.1. Insert braces

+Per definition braces are superfluous on single statements, but it is +a common recommendation that braces should be always used in such cases. +With this option, you can specify whether missing braces for single +statements should be inserted for the control statements if, +for, while and do-while. +

+Enabling this option for while statements would render +

Example 4.4. Brace insertion

+while (!isDone)
+    doSomething();
+

+into +

+while (!isDone)
+{
+    doSomething();
+}
+

4.3.1.2.2. Remove braces

+It is permittable to remove braces in case they are superfluous. This not only +applies to the control statements if, for, +while and do-while, but also to every +block in general (remember a block is just a sequence of statements, +local class declarations and local variable declaration statements within +braces). +

Example 4.5. Brace removal

+for (int i = 0; i < 100; i++)
+{
+    sum += value[i];
+}
+

+would become +

+for (int i = 0; i < 100; i++)
+    sum += value[i];
+

4.3.1.2.3. Empty braces

+Controls how empty braces should be handled. If no option is selected, +they are left untouched. +

Example 4.6. Empty braces

+if (in != null)
+{
+    try
+    {
+        in.close();
+    }
+    catch (IOException ignored)
+    {
+    }
+}
+

+All options don't apply to class/interface and method/constructor bodies but +are only used for control statements and blocks. +

+Insert empty statement + + + +
+Inserts an empty statement to make it obvious for the reader that the empty braces +are intentional. +
Example 4.7. Empty braces with empty statement
+if (in != null) +{ + try + { + in.close(); + } + catch (IOException ignored) + { + ; + } +} +

+Cuddle braces +
+Cuddles the braces. They will be printed right after the control statement. + + +
Example 4.8. Cuddled empty braces
+if (in != null) +{ + try + { + in.close(); + } + catch (IOException ignored) {} +} +