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:
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.