Fix invalid return type in docblock

[dagio]

No description provided.

[doctrinebot]

Hello,

thank you for creating this pull request. I have automatically opened an issue
on our Jira Bug Tracker for you. See the issue link:

http://www.doctrine-project.org/jira/browse/DDC-3881

We use Jira to track the state of pull requests and the versions they got
included in.

[Koc]

It is better use @return $this here. An explanation https://github.com/php-fig/fig-standards/pull/169/files#diff-9a10a11696dc38209c125ea9c57a565fR2195

[DHager]

For "fluent" chaining, can you use @return self or @return $this , or are those only recognized by certain IDEs?

[dagio]

@DHager Yes. For the moment I just fixed the one that were incorrect so know all method returning $this have QueryBuilder as return type so in IDEs we have no more issues reported. @returns $this and @returns self are not used a lot in the project so I would let you guys decide the right choice.

[dagio]

@Koc @DHager I updated in favor of @return $this as recommended in PSR-5 draft

[Koc]

@dag-io can you check consistency in other classes, like https://github.com/doctrine/doctrine2/blob/master/lib/Doctrine/ORM/AbstractQuery.php#L343 and others?

[dagio]

@Koc, it's all good now

[TomasVotruba]

👍

[Ocramius]

static was correct here

[Ocramius]

I manually applied the patch after a rebase and reverting $this to self or static (depending on context).

Thanks @dag-io, sorry for the long delay!

[TomasVotruba]

Thank you @Ocramius