Refined documentation and added .yardopts to play nicely with TomDoc
Refacted pairs methods to avoid aliasing.