Question

According to PhpDocumntor each block of comment in order to be converted into a valid piece of documentation requires to be encapsulated like this:

/**
* This function is used blah, blah, blah
* line 2
* line 2
* ...
*/
function MyFunc($string) {...

Do you know if it’s possible (maybe by changing some settings) to avoid being forced to place an asterisk in front of each line. I would basically like PhpDocumentor to accept and translate to documentation these type of comments:

/**
This function is used blah, blah, blah
line 2
line 2
...
*/
function MyFunc($string) {...

I’m asking because JsDOC and JavaDoc do not require a damn asterisk in front of each new line anymore, so I thought tat maybe also PhpDocumentor can do this by tricking a bit its settings, but I can’t find anything about this on Google.

Answer 1

There is no way to do it using PhpDocumentor.

I gave up on PhpDocumentor and started using Doxygen. For anyone who might be interested, Doxygen allows final user to document PHP function in many ways among which also like JavaDoc and JsDoc. And you are NOT forced to place a ‘damn’ asterisk at the beginning of each line in documentation, so the following comments are ok and will be properly parsed by Doxygen:

/**
... line1 ...
... line2 ...
*/
function MyFunc($string) {...