Merge pull request barryvdh#2 from JeppeKnockaert/add-brackets-for-pa…

…rsing-return-types

feature - Improve method tag parsing

Merge pull request barryvdh#1 from JeppeKnockaert/allow-deleting-tags…

…-in-docblocks

Allow deleting tags in DocBlocks

Update namespace

Move around

Correct namespace

Fixed the dot separation to match the latest PSR

(see phpDocumentor/phpDocumentor#797)

Added "scalar" as a recognized keyword (phpDocumentor/phpDocumentor#694…

…);

Changed the list of keywords to be static (for the purpose of reducing memory consumption);
Updated composer.lock with the latest dependencies (PHPUnit in particular).

CS fixes.

Change behaviour of @param parsing

In issue report phpDocumentor/phpDocumentor#620 @bobef reported that when he
used just a Type as content of the @param that it would be recognized as
description instead of the Type.

According to the unit tests this is correct behaviour but after reviewing the
pattern of the output his version is more consistent. As such I have altered
the behaviour to act as following:

If only one word is found after an @param (word means white-space bounded
series of characters) then interpret that as the type and not description.

During this item several issues in unit tests were fixed and a new 'Type'
Collection was introduced that is capable of expanding types based on a given
namespace and series of aliases.
This should be re-used in phpDocumentor's Transformer as a duplication exists
there with the expanding of the Types.

Please note: the suggested format by @bobef is not valid according to the
PHPDoc Standard but is provided for convenience.

Multiline @return statements were stripped from their newlines and in…

…dent

@return statements (and effectively others) were stripped from their newlines
and indentation. By tweaking the reflection a bit was this effect countered.