PHP函数声明上面的奇怪评论

Question

我注意到很多脚本都有这些类型的注释:

/**
 * Retrieve list of themes with theme data in theme directory.
 *
 * The theme is broken, if it doesn't have a parent theme and is missing either
 * style.css and, or index.php. If the theme has a parent theme then it is
 * broken, if it is missing style.css; index.php is optional. The broken theme
 * list is saved in the {@link $wp_broken_themes} global, which is displayed on
 * the theme list in the administration panels.
 *
 * @since 1.5.0
 * @global array $wp_broken_themes Stores the broken themes.
 * @global array $wp_themes Stores the working themes.
 *
 * @return array Theme list with theme data.
 */
function get_themes() {
    global $wp_themes, $wp_broken_themes;

    ...

    return $wp_themes;
} 

它看起来像函数的某种文档,但是前面提到的单词是@什么？

喜欢@since,@ global,@return,@ access,@ param等...？

我知道他们的意思,但为什么他们在他们面前？他们是否需要识别某种文档应用程序？

Answer 1

这是JavaDoc标准.作者很可能选择它,因为大多数IDE会自动格式化它.

http://en.wikipedia.org/wiki/Javadoc