update comments, relates to #5