generics-and-placeholders-in-docblocs.php

<?php
class Factory
{
    /**
     * @param string:T $className
     * @return T
     */
    public function create($className)
    {}

    /**
     * @param string:T $className
     * @return T[]
     */
    public function createList($className)
    {}
}

/**
 * @self T
 */
abstract class Model_Abstract
{
    /**
     * Will return Model_Abstract\Collection
     * 
     * @return {T}\Collection
     */
    public function getCollection()
    {
    }
    
    /**
     * Will return Model_Resource_Abstract
     * 
     * @return {T/Model/Model_Resource}
     */
    public function getResource()
    {
    }
}