adding some javadocs to BlockBase