further javadoc'ing (it never ends...) - see #75