final-ish javadocs for evan