fixes various nits in the behaviour of the '-m' option, amongst other things. update the docco to suit.