并不是phpdoc标头中的所有内容都显示出来

Question

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

/**
 * 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

在“支持基数2、基数10、基数16和基数256”之后，什么也看不到。出现了。有什么想法可以解释原因吗？

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

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

​

​

有什么想法吗？谢谢!

Answer 1

我会转载我在https://github.com/phpDocumentor/phpDocumentor2/issues/804#issuecomment-17437818上给出的答案。

您的文件类(您引用的那个)包含一个完整的解释；而您看到的文本是

DocBlock (https://github.com/phpseclib/phpseclib/blob/master/phpseclib/Math/BigInteger.php#L174)。

此时，响应式模板仅显示类DocBlock；文件尚未表示为