better comments

Signed-off-by: Ben Jackman <ben@jackman.biz>