moved comments into doc strings