Когда сталкиваюсь с opensource-проектами, в исходниках часто вижу комментарии такого типа:
/**
* Set the default fetch mode for this statement
* @param mixed $mode fetch mode
* @return CDbCommand
* @see http://www.php.net/manual/en/function.PDOStatement-setFetchMode.php
* @since 1.1.7
*/
public function setFetchMode($mode)
{
$params=func_get_args();
$this->_fetchMode = $params;
return $this;
}
Полный код библиотеки здесь.
Многие распространенные IDE этот формат комментирования понимают, и строят на его основе автодополнение кода. Это очень удобно. Да и читабельность кода на высшем уровне.
Вот интересно, что за стандарт такой? Где с ним можно поподробнее познакомиться?
И, если существуют другие стандарты для различных языков, про них тоже было бы интересно узнать.
// TODO:
, которые идеешка автоматически сканирует и выводит в отдельный список. Радовался как ребенок :). Век живи - век учись!java
. Конкретно в джаве такие комментарии называются JavaDoc.