Adding support section/segment separating comments

[Behrang Saeedzadeh]

I remember I had seen in the past in another language, but the point is
giving users some pointers about what methods in a section are doing in
general. For example:

public class Foo {

// @section properties

public int getBar() { ... }
public void setBar(int bar) { ... }

// @section event handling

public void addActionListener(...) { ... }

// @section rendering

public void draw(Graphics g) { ... }
}

This can motivate new users to add methods to the right section in the code
to keep it consistent over time.

Also IDEs can use this information to categories methods based on the
section they belong to (or they purpose).

Cheers,
Behrang Saeedzadeh
http://www.behrang.org