Details
-
Type:
Bug
-
Status:
Resolved
-
Priority:
Trivial
-
Resolution: Fixed
-
Affects Version/s: 1.11.1
-
Fix Version/s: 1.11.3
-
Component/s: None
-
Labels:None
Description
According to phpDocumentor, the correct format of @param is:
@param datatype $paramname description
There are some instances in the codebase where the datatype is omitted or the terms are out of order (i.e. @param $foo string)
For example, run this in the library dir:
find . -name '*.php' -print0 | xargs -0 grep -P '@param[ ]+\$'
The main side effect is that IDEs are generally be unable to do correct code completion/hinting for these methods.
I'll start working on this. 76 files are affected as of r23578.