Changing our function definition syntax in the manual
| From: | Julien Pauli | Date: | Tue, 10 Nov 2015 20:19:45 +0000 |
| Subject: | Changing our function definition syntax in the manual | ||
| Groups: | php.doc | ||
| Request: | Send a blank email to phpdoc+get-969385944@lists.php.net to get a copy of this message | ||
Hey people.
Today I got twitted about an interresting idea.
The twitt (https://twitter.com/tvlooy/status/664109119343878144) was
about why don't we show function syntax for description using the new
declaration syntax used in PHP 7 parser ?
Example for http://php.net/manual/en/function.random-int.php
Actual :
********
Description
int random_int ( int $min , int $max )
Suggested :
*************
Description
random_int ( int $min , int $max ) : int
This is not senseless , now that we trully support such a syntax in
the language.
However, wouldn't such a global manual change hurt some people ?
I don't know.
Thoughts ?
Julien Pauli