some additional comments for functions