update docstrings
related to issue #99: allows recalibration from within calib
calib looks OK, recalib is untested