Added custom DocCommentSniff to better cover function doc comments and others.
Fixed doc comment tag value indentation and full stop end of comment short descriptions.
Fixed parameter indentation sniff.
Fixed @return comment detection and indentation.
Fixed line numbers of some changed doc sniffs in tests.