more doco and minor tweaks