ENH/DOC: more realm mismatch errors. Documented filter design criteria