Comments for the Doc

Added relevant comments for functions that were vaguely or inaccurately described.