improve doxygen formatting in some Hlms classes

[jwwalker]

improve doxygen formatting in Hlms, HlmsDatablock, HlmsPbsDatablock, and HlmsListener classes

[darksylinc]

Thanks!

I'm curious: What sort of cursed formatting needs "i.e. explanation" to become "i.e., explanation" ?

[jwwalker]

@darksylinc In some cases, I'm not sure of the exact rules, the period followed by a space made Doxygen do a paragraph break. But I was taught in school that putting a comma after "i.e." and "e.g." is more correct anyway, so I didn't bother looking deeper.

[jwwalker]

I think it's that Ogre sets the Doxygen setting JAVADOC_AUTOBRIEF to YES, which means that "Doxygen will interpret the first line (until the first dot) of a Javadoc-style comment as the brief description".