Many functions are already have a DocBlock, for example:

/**
 * creates directory if not exists; ensures that directory is writable
 * @param:
 *  string $dir
 *  int $flags combination of MKGETDIR_xxx
 * @return bool false on error else true
 */
function mkgetdir($dir, $flags=MKGETDIR_DEFAULT)

or

/**
 * Redirects to the given URL (HTML method)
 *
 * Note : once this function called, the execution doesn't go further
 * (presence of an exit() instruction.
 *
 * @param string $url
 * @param string $title_msg
 * @param integer $refreh_time
 * @return void
 */
function redirect_html( $url , $msg = '', $refresh_time = 0)

so I think it would be good to make this documentation officially requested.

mistic wrote:

Is it doable for 2.6 ?

I don't think we can say "let's make the whole code comply with phpDocumentor for 2.6". But we can say that from now we respect the syntax for new functions/classes and that we progressively add/convert docBlocks.

mistic wrote:

interesting in the description of a parameter, in witch version of Piwigo it was added

Not always easy to know (a change in the line endings will break investigation in SVN history)

mistic wrote:

add the @since tag for new functions.

Yes! easy and very useful.

I don't know how PHPDoc is flexible, does he understand various syntaxes from scratch or must the syntax be exactly as described in their doc ? (it's an open question, I don't expect an answer ^^)