In phpDoc-generated documentation I can cause phpDoc to generate a link to a custom type definition for a given param using
@param CustomType $variablename
New version of PHP doc support /** @var sometype[] */ syntax. Even more complicated: /** @var (sometype|othertype)[] */. http://www.phpdoc.org/docs/latest/guides/types.html#arrays PHPStorm also support this syntax.
/** @var sometype[] */
/** @var (sometype|othertype)[] */