#196 add some JavaDoc