javadocs for methods
and easy refactorings from NetBeans hints