如何解决phpDocumentor 在我的代码中没有找到 TODO 标记?
当我使用 phpDocumentor 生成 API 文档时,页面 报告 -> 标记 总是说在这个项目中没有找到标记,尽管我的 PHP 代码中有几个 TODO 标记。
我有 phpDocumentor v3.0.0。我运行它:php phpDocumentor.phar --markers
我的 phpdoc.dist.xml 文件包含:
<?xml version="1.0" encoding="UTF-8" ?>
<phpdocumentor
configVersion="3"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns="https://www.phpdoc.org"
xsi:noNamespaceSchemaLocation="https://docs.phpdoc.org/latest/phpdoc.xsd">
<paths>
<output>apidocs/docs</output>
<cache>apidocs/cache</cache>
</paths>
<version number="3.0.0">
<api>
<source dsn=".">
<path>src</path>
<path>*.php</path>
</source>
<markers>
<marker>TODO</marker>
</markers>
</api>
</version>
</phpdocumentor>
我在 PHP 代码中使用 TODO 标记,如下所示:
/**
* TODO marker 1
*/
function someFunction(...) {
// ...
}
function anotherFunction(...) {
// TODO marker 2
// ...
}
版权声明:本文内容由互联网用户自发贡献,该文观点与技术仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容, 请发送邮件至 dio@foxmail.com 举报,一经查实,本站将立刻删除。