fix #629 - clarify minmag/maxmag documentation and make implementation conform to it