Multiple @todo in phpDoc

Question

I have multiple todo items I want to add for a function.

What is the correct way to add them in a phpDoc comment block?

I understand that I should use the @todo tag. But I am unsure of whether I should use a single @todo tag per item, or one @todo tag for the whole list.

Answer 1

Zero or more @todo tags is valid.

PSR-5: PHPDoc

Syntax

@todo [description]

Example

/**
 * Counts the number of items in the provided array.
 *
 * @todo add an array parameter to count
 *
 * @return int Returns the number of elements.
 */
function count()
{
    <...>
}