DOC/TEST improved doc and tests on the paired distances