I do like the visual separation achieved by the hyphen in the PHP source
code, but am not attached to any particular way of accomplishing such
separation. I read code, and rarely ever bother reading the extracted
phpdoc summary, as I usually want to also see the function's definition.
Any ideas on alternative ways to accomplish the visual separation of
parameter descriptions without using a hyphen?
Erase only the hypen...
* @param bool $param2 OPTIONAL Description goes here (default: false)
* @param string|array $flags A flag or array of flags.
But let the whitespaces to the description of the parameter.
So all parameter descriptions are at the same intention.
So phpdoc should work correct, and the pure API doc is also more readable
Greetings
Thomas
