docblock modifications (closes #301)