http://www.jindent.com

Previous:  Try/Catch

Next:  Braces/Parentheses Insertion

5.6.1.3.10 Presets

• K&R/Kernal Syle (aka Sun or Java Style)
  
  The K&R style, so-called because it was used in Kernighan and Ritchie's book The C Programming Language, is somewhat common. It keeps the first opening brace on the same level as the initial statement (i.e. for a while loop), while using the closing brace to denote the block's end.
  
  

  while(x == y) {                              something();                             somethingelse();                     }

  
  The advantages of this style are that the ending brace lines up with the statement it conceptually belongs to; and the beginning brace does not occupy an entire line by itself.
  
  The disadvantage of this style is that the beginning brace can be more difficult to locate than with the BSD style.*
  
  
  
• K&R/Kernal Spacious Syle (aka Spacious Sun or Java Style)
  
  This is an enhancement of the K&R/Kernal Style.
  
  If a block or body contains at least 2 lines of source code then an extra blank line will be inserted after left brace:
  
  

  while(x == y) {                                                                       something();                             somethingelse();                     }

  
  
  Additionally the extra blank line will be inserted before right braces in blocks of if-else and do-while statements.
  
  

  public int getA() {                          return a;                            }                                                                                 public void doSomethingMore() {                                                       if (a == 10) {                                                                        callMethodA();                           callMethodB();                                                                } else {                                                                              callMethodC();                           callMethodD();                       }                                                                                 // but:                                  if (a == 10) {                               callMethodA();                       } else {                                     callMethodC();                       }                                    }

  
  The advantage of this style is that small blocks (e.g. typical small getter/setter methods) are kept compact, but all other bodies and blocks containing more than one line are formatted more spacious.
  
  
  
• BSD/Allman Syle (aka C/C++ Style)
  
  The BSD/Allman style is relatively common. It keeps the braces after the initial statement, and tabs out the blocked statements.
  
  

  while(x == y)                            {                                            something();                             somethingelse();                     }

  
  The advantages of this style are that the indented code is clearly set apart from the containing statement by lines that are almost completely whitespace; the braces line up with the statement they conceptually belong to; and the ending brace lines up with the beginning brace.
  
  The disadvantage of this style is that the beginning brace occupies an entire line without adding any functionality to the code. This once was an important consideration when programs were usually edited on terminals that displayed only 24 lines at once.*
  
  
  
• Whitesmiths Style
  
  The Whitesmiths style is somewhat like the BSD style:
  
  

  while(x == y)                                {                                        something();                             somethingelse();                         }

  
  The advantages of this style are similar to those of the BSD style. Some advocates of this style will point out that strictly speaking the braces combine a series of declarations and statements into a single statement. Therefore, they should be indented as subordinate to the while instead of lined up with it.
  
  The disadvantage of this style is that the braces do not stand out as well as with the BSD style.*
  
  
  
• Gnu Style
  
  The GNU style is mixture of BSD and Whitesmiths.
  
  

  while(x == y)                              {                                          something();                             somethingelse();                       }

  
  This style maintains the advantages of BSD while satisfying those who prefer Whitesmiths.
  
  A possible disadvantage of this style is that deep nesting will cause lines to start very far to the right, possibly causing the lines to wrap around and making them harder to read, but this is ameliorated by indenting the braces by only 2 spaces and the body by another 2, with a net effect no worse than the other styles. This style is the default behavior of GNU Emacs, and is mandated by nearly all maintainers of GNU project software.*