#2209 - add the example @tianon gave to elaborate on the Comment docume...

...ntation