a few updates to the comments

Signed-off-by: Ralf Koller <r.koller@gmail.com>