overhaul manual in docblock