PHPdoc Netbeans - @deprecated и ссылка на другой (новый) метод класса - пример оформления комментариев

Предположим, что мы перенесли эту функцию, например, в другой класс (с использованием автозагрузки) и хотим указать другим программистам, что лучше использовать другой метод, тогда можно оформить комментарии следующим образом (phpDocumentor):

/**   
 * Определит принадлежит ли ОС к семье Windows 
 * (определение операционной системы)
 * 
 * @deprecated
 * @see \Server\OS::isWindows() - удобнее вызывать  этот метод
*/
function is_windows() {
   /* здесь реализация функции */
}