Feature/docblock method chaining consistency

[tdutrion]

As discussed in fluent interface return type vs return self #7193, this changes remove occurrences of class names and self keyword from the DocBlocks

[marc-mabe]

interestingly the test for PHP-7.0 results in segmentation fault https://travis-ci.org/zendframework/zend-cache/jobs/165922572#L9937 :(

[tdutrion]

Could it be related to an update of the apcu version? I don't use travis much, I'll keep digging, but if you think that's what it is please let me know.

[marc-mabe]

Yea this looks very related. I'll try this setup at home to see if it's it.

In case it's because of APCu and unrelated to your changes I'll merge and see if I can provide a simple reproduce script to help the APCu developer.

Anyway thanks for the catch!

[marc-mabe]

@tdutrion ok the segfault definitely happens with APCu-5.1.6 -> see https://bugs.php.net/bug.php?id=73286 and krakjoe/apcu#203

[sergeyklay]

Yes, just use 5.1.5:

git clone -q https://github.com/krakjoe/apcu -b v5.1.5 /tmp/apcu
cd /tmp/apcu

phpize &> /dev/null
./configure &> /dev/null

make --silent -j4 &> /dev/null
make --silent install

git clone -q https://github.com/krakjoe/apcu-bc /tmp/apcu-bc
cd /tmp/apcu-bc

phpize &> /dev/null
./configure &> /dev/null

make --silent -j4 &> /dev/null
make --silent install

apcu_bc.ini

[APCu]
extension=apcu.so

[APC]
extension=apc.so
apc.enabled=1
apc.enable_cli=1

See krakjoe/apcu#203

[marc-mabe]

FYI: the APCu issue has been fixed in the latest version

[DASPRiD]

$this is not a valid return type, in terms of PHP-doc. Does any IDE actually understand that?

[tdutrion]

Please go up in my very first message (before all the problems with apcu), and give your opinion on the issue on the zendframework repository (the thread is pretty much dead at the moment...).

I can definitely edit this PR as long as we settle on a comment that can be used throughout the codebase.

[tdutrion]

The PR has been edited to reflect the latest outcomes of the discussion :)

[tdutrion]

Updated + up to date with the develop branch.