library: comments for new and changed functions