Re: PHP 7.2 Migration Guide
| From: | Christoph M. Becker | Date: | Tue, 28 Nov 2017 23:32:02 +0000 |
| Subject: | Re: PHP 7.2 Migration Guide | ||
| References: | 1 2 3 4 5 6 7 8 | Groups: | php.doc |
| Request: | Send a blank email to phpdoc+get-969386822@lists.php.net to get a copy of this message | ||
On 28.11.2017 at 18:13, Kalle Sommer Nielsen wrote:
> Thanks for the work you put into the guide, our biggest task is by far
> Sodium /o\
I've ran
docgen -e sodium, and the results are as good as expected,
except that all return types are given as ReturnType and all parameter
types are string. I don't have the time to fill in the details
(particularly, since ext/sodium has no "protos" or other comprehensive
documentation, and there are 73 functions), and unless somebody else is
going to tackle this task, I would suggest to commit the results.
However, in my opinion documenting unknown types as string is a bad
idea, so it might be best to document the unknown types as unknown or
?, or to omit them altogether.
Thoughts?
--
Christoph M. Becker