Monday, March 22, 2010

Так документировать код нельзя.

Сижу поздним ночером, хочу спать, нужно чуть изменить функционал модуля. Открываю, вижу

 
/**
* Returns the data model based on the primary key given in the GET variable.
* If the data model is not found, an HTTP exception will be raised.
* @param integer the primary key value. Defaults to null, meaning using the 'id' GET variable
*/
public function loadUser()
{
if($this->_model===null)
{
if(Yii::app()->user->id)
$this->_model=User::model()->findbyPk(Yii::app()->user->id);
if($this->_model===null)
$this->redirect(Yii::app()->controller->module->loginUrl);
}
return $this->_model;
}


Ну и как это вообще называется? Я бы убивал таких документаторов.

Где exception?
Где GET?
Где param int ?
Что return ?

Я уже промолчу про шедевральный

Yii::app()->controller->module->loginUrl

В корне поменявший поведение по умолчанию.


P.S.

Понял откуда это взялось, эту документацию и метод yii генерирует в контроллере при использовании crud команды. (За исключением @param int )

No comments:

 
Каталог сайтов, Добавить сайт