Add some DocBlock comments to Yii sources that will improve code autocompletion in IDE

[nayjest (Mail)]

I propose to add DocBlock comments "@property <type> <$name>" for classes that have <get|set><Name> methods, that can be used as properties due to magic setters/getters in CComponent.

This will make coding with Yii little more convenient due to better code autocompletion in IDE.

Example for CController:

• @property CWebModule $module

• @property CAction $action

• @property string $id

• @property string $uniqueId

• @property string $route

• @property string $viewPath

• @property string $pageTitle

• @property array $actionParams

• @property CMap $clips

• @property CStack $cachingStack

[samdark (Alexander Makarov)]

These comments should include description as well. Also if there is only get method then it should be @property-read.

I will accept patches adding such phpdoc. Just post these at code.google.com/p/yii.