PHPdoc: ¿Documentando métodos encadenables?

Question

¿Cómo debo usar PHPdoc para documentar métodos encadenables en una clase, como se ve en el ejemplo a continuación? ¿Cuál es el uso correcto?

class myClass { 


    /** 
    * @return myClass 
    */ 
    function one() 
    { 
     return $this; 
    } 

    /** 
    * @return self 
    */ 
    function two() 
    { 
     return $this; 
    } 

    /** 
    * @return $this 
    */ 
    function three() 
    { 
     return $this; 
    } 

} 

Answer 1

/** 
* @return myClass 
*/ 

No soy un experto phpDoc pero es que así es como lo hacen en el marco de Zend. Así que creo que es fiable

Answer 2

prefiero

/** 
* @return $this 
*/