improved @throw- & @return-doctag output and made the turned the sample block-comment into a real block-comment