Ошибка Doxygen php

У меня есть файл php (doxygen.php), который я хотел бы задокументировать. Проблема в том, что когда я запускаю doxygen doxygen.php в Linux, он ничего не генерирует... файл index.html пуст. я получил

Warning: ignoring unknown tag `php' at line 1, file doxygen.php
Warning: ignoring unknown tag `does' at line 4, file doxygen.php
Warning: ignoring unknown tag `nothing' at line 4, file doxygen.php
....

Кажется, что он не распознает комментарии должным образом. Мой файл doxygen.php имеет следующее:

<?php


/* does nothing
 * @param teste
 * @return null
 */
function foo($foo) {
    echo 'hi'.$foo;
    return null;
}

?>

php doxygen
person out_sider    schedule 16.12.2010    source источник
comment
какая версия doxygen у вас стоит?   -  person FatherStorm    schedule 16.12.2010

Ответы (3)


arrow_upward
1
arrow_downward

при использовании doxygen вы должны отключить свои комментарии с помощью

/** ...*/

or /*!...*/

см. страницу doxygen "документирование кода"

person FatherStorm    schedule 16.12.2010

arrow_upward
0
arrow_downward

Пытаться

/**
 * does nothing
 *
 * @param teste
 * @return null
 */
person Mchl    schedule 16.12.2010
comment
должно быть что-то с конфигом doxygen. Помимо использования /* вместо /** ваш синтаксис выглядит нормально. - person Mchl; 16.12.2010

arrow_upward
0
arrow_downward

Вы забыли включить данные файла. вместо этого используйте этот код:

/**
* @file
* Test file intended for doxygen testing
*/


/**
 * does nothing
 *
 * @param teste
 * @return null
 */

function foo($foo) {
    echo 'hi'.$foo;
    return null;
}

Это будет работать. проверил это с моим doxygen.

person Ran Bar-Zik    schedule 17.02.2011