Compare all 3 positions, improve function docs

Comparing all 3 positions is a more useful example. Include
documentation about vercomp caveats.