documentation: more general comparisons