improved box javadoc