further docblock updates