small additions including docblocs