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

Generate ext/spl methodsynopses based on stubs #624

Merged
merged 4 commits into from
Aug 11, 2021

Conversation

kocsismate
Copy link
Member

No description provided.

Copy link
Member

@Girgias Girgias left a comment

Choose a reason for hiding this comment

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

Common issue is that if the return type of a function changes then this its section usually needs updating, either that or the stubs are wrong.

ArrayObject/ArrayIterator is a mess because of the whole sort functions and ArrayAccess interface shenanigans so it might make sense to split this part of.

Otherwise, except where comments are LGTM.

reference/spl/arrayiterator/asort.xml Show resolved Hide resolved
reference/spl/arrayiterator/ksort.xml Show resolved Hide resolved
reference/spl/arrayiterator/natcasesort.xml Show resolved Hide resolved
reference/spl/arrayiterator/offsetexists.xml Outdated Show resolved Hide resolved
reference/spl/arrayiterator/offsetget.xml Outdated Show resolved Hide resolved
reference/spl/splobjectstorage/addall.xml Show resolved Hide resolved
reference/spl/splobjectstorage/count.xml Show resolved Hide resolved
@kocsismate
Copy link
Member Author

I've just incorporated our latest stub fixes. @Girgias can you please take another look?

Copy link
Member

@Girgias Girgias left a comment

Choose a reason for hiding this comment

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

Mostly good other than two nits/clarifications.

Also it might be better to use the &falseonfailure; (or whatever its actual name is) for many of the false returns instead of writing it out by hand each time, but that's an aside.

reference/spl/splobjectstorage/count.xml Show resolved Hide resolved
reference/spl/splfileinfo/getpathinfo.xml Outdated Show resolved Hide resolved
@@ -8,7 +8,7 @@
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<modifier>public</modifier> <type>string</type> <methodname>DirectoryIterator::key</methodname>
<modifier>public</modifier> <type class="union"><type>int</type><type>false</type></type><methodname>DirectoryIterator::key</methodname>
Copy link
Member

Choose a reason for hiding this comment

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

I don't think it can be false, it either throws or returns an int, must have returned false prior to throwing

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants