doctrine/doctrine2 — pull request #498 by lanthaler (2012-11-02 16:21:18+00:00)
Title: Improve DocBlock annotations of generated entities

Currently, the DocBlock annotations for member variables contain the variable name as description which is redundant and should be removed. Furthermore the class is annotated with the FQN instead of just the name. This makes automatically generated documentation quite ugly.

These changes will result in entities that as follows

```
/**
* User
*
* @ORM\Table()
* @ORM\Entity
*/
class User
{
/**
* @var string
*
* @ORM\Column(name="name", type="string", length=255)
*/
private $name;
```

instead of this:

```
/**
* Some\Completely\Random\Namespace\User <--- FQN is not needed here
*
* @ORM\Table()
* @ORM\Entity
*/
class User
{
/**
* @var string $name <--- description is better left blank instead of using variable name
*
* @ORM\Column(name="name", type="string", length=255)
*/
private $name;
```