Fix return type comments

[photodude]

• Support both a return type and a description
• Fix false positive when function contains closure or anonymous class
• fixes Joomla.Commenting.FunctionComment.InvalidReturn errors with return type comments #228

Adds tests to cover these changes

Changes adopted from Squiz.Commenting.FunctionComment PHPCS 3.x branch which addressed these issues.

Note: PEAR.ControlStructures.MultiLineCondition.Alignment is struggling here the same lines gives

• Multi-line IF statement not indented correctly; expected 32 spaces but found 28.
  or after fixing
• Multi-line IF statement not indented correctly; expected 28 spaces but found 32.
  This is a PHPCS indenting issue.