more pontification in doc strings