remove misleading comment
fix doc of dimensions()