php - 并非 phpdoc 标头中的所有内容都显示出来

Question

我正在尝试在phpseclib 的 Math_BigIntegerphpdoc -d . -t output上使用 phpDocumentor ( )创建一些文档，并且有几个问题。这是标题：

/**
 * Pure-PHP arbitrary precision integer arithmetic library.
 *
 * Supports base-2, base-10, base-16, and base-256 numbers.  Uses the GMP or BCMath extensions, if available,
 * and an internal implementation, otherwise.
 *
 * PHP versions 4 and 5
 *
 * {@internal (all DocBlock comments regarding implementation - such as the one that follows - refer to the 
 * {@link MATH_BIGINTEGER_MODE_INTERNAL MATH_BIGINTEGER_MODE_INTERNAL} mode)

这是 phpDoc 的渲染图：

http://www.frostjedi.com/terra/dev/phpdoc/classes/Math_BigInteger.html

在“支持 base-2、base-10、base-16 和 base-256 数字”之后可以看到任何内容。正在出现。关于为什么的任何想法？

另外，我尝试phpdoc -pp -d . -t output查看标题中的内部文本，但这也不起作用。大概也是出于同样的原因。

这是我期望它出现的地方：

有任何想法吗？谢谢！

Answer 1

我将重新发布我在https://github.com/phpDocumentor/phpDocumentor2/issues/804#issuecomment-17437818给出的答案。

您的 File DocBlock（您所指的那个）包含完整的说明；而您看到的文本是 Class DocBlock ( https://github.com/phpseclib/phpseclib/blob/master/phpseclib/Math/BigInteger.php#L174 )。

此时响应式模板只显示Class DocBlock；文件尚未呈现