javadocs for Figurate iterables