开发者

Doxygen php error

开发者 https://www.devze.com 2023-01-31 10:24 出处:网络
I have a php (doxygen.php) file which I\'d like to document. The problem is wen I run doxygen doxygen.php on linux it doesn\'t generate anything...index.html file is empty. I get

I have a php (doxygen.php) file which I'd like to document. The problem is wen I run doxygen doxygen.php on linux it doesn't generate anything...index.html file is empty. I get

Warning: ign开发者_运维技巧oring 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
....

It seems that it doesn't recognize the comments properly. My doxygen.php file has this:

<?php


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

?>


when using doxygen you have to set your comments off with

/** ...*/

or /*!...*/

see the doxygen "documenting the code" page


Try

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


You forgot to include file data. use this code instead:

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


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

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

It will work. tested it with my doxygen.

0

精彩评论

暂无评论...
验证码 换一张
取 消