docgen should recognise Synonym / Example

[graememcc]

... as well as the currently recognised plural forms. Some of the comments can then be made more grammatical.

Note: need to update the problematical line finder (and associated tests).