Fix api documentation

refs #4883

Just in-comment changes.

cc @DeepDiver1975 @karlitschek @Kondou-ger