add some javadocs to BuildableCriteria