while I'm here, fix numerous spelling, grammar, and -mdoc macro usage bugs
macros; contributed by S.P.Zeidler <spz@serpens.swb.de>.