Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

add / fix some phpdocs #892

Merged
merged 10 commits into from
Sep 14, 2020
Merged

add / fix some phpdocs #892

merged 10 commits into from
Sep 14, 2020

Conversation

voku
Copy link
Contributor

@voku voku commented Aug 15, 2020

No description provided.

+ fix some return types
+ normalize the param phpdocs
+ normalize the "php.net" links (language "en" as default)
* @return string the name of the event that was posted.
*/
function ibase_wait_event ($event_name1, $event_name2 = null, $_ = null) {}
function ibase_wait_event (...$event_names) {}
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I can't find any proofs of this. Have you checked this?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yes, but it's not 100% correct in both cases. :-/

https://github.com/php/pecl-database-interbase/blob/2044c06d94126115b38de5487cc2119a45aad6bb/ibase_events.c#L125

ibase_wait_event ( string ...$event_names) : string
ibase_wait_event ( resource $link_identifier, string ...$event_names) : string

* @return void
*/
function var_dump ($expression, $_ = null) {}
function var_dump (...$expressions) {}
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

it's not the same because it also means that I can use this function without any arguments but actually I can't. Could you also check other similar changes?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

You are right, checked and reverted. 👍

@slapoguzov
Copy link
Contributor

@voku please, take a look at tests, seems some tests are broken after adding & to phpdocs

@voku
Copy link
Contributor Author

voku commented Sep 1, 2020

@slapoguzov I tried to fix this problem upstream (phpDocumentor/ReflectionDocBlock#254) or is this behavior expected?

@slapoguzov
Copy link
Contributor

@voku I think it's a bug in phpDocumentor. I suggest excluding changes that break tests from this MR and merge it. And you can open a new MR with these changes when the problem in phpDocumentor is resolved.

@voku
Copy link
Contributor Author

voku commented Sep 3, 2020

@slapoguzov the bug in phpDocumentor is fixed :)

@slapoguzov slapoguzov merged commit 5b7def2 into JetBrains:master Sep 14, 2020
@DmitryTronin DmitryTronin mentioned this pull request Sep 16, 2021
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
2 participants