使用PHPDoc提供@return可能的值和含义

Question

I understand the @return annotation can be used when a function returns something, eg :

@return int The count of created elements

What if the function returns for example a status code ? I wish I could document all status code's meanings in the annotation. Can this be done ?

Sure I can do what follows, but I doubt these information will actually be seen by PHPDoc as potential values, but rather as plain text.

/**
 * @ return int The status code
                                0 => Success
                                1 => Connection failure
                                2 => Bad parameters
*/