This branch adds javadocs to some BDF classes and deprecates methods for handling non-canonical BDF. Related to !1772 (merged).