improved package docblock