added some comments and housekeeping

Signed-off-by: degrigis <degrigis@gmail.com>