More docs / comments changes.

Signed-off-by: Dan Bohea <git@bohea.co.uk>