fixed most comments, almost done

need ack and ref