Enhanced traanslator comments documentation.

Partial (docs only) backport of 47ddd6a from master.