real: doc and comment fixes.