Hello,

Just comment updates, and a bit of documentation.
Not sure if the comment changes need a ChangeLog.

OK for trunk?

Ciao!
Steven