fix docblock to match convention.
add a test for orthogonality.