updated docs & comments.