并非phpdoc标题中的所有内容都显示出来

时间:2013-04-28 04:19:02

标签: php phpdoc phpseclib

我正在尝试使用phpseclib's Math_BigInteger上的phpDocumentor(phpdoc -d . -t output)创建一些文档,并提出了一些问题。这是标题:

/**
 * 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来查看标题中的内部文本,但这也不起作用。可能出于同样的原因。

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

enter image description here

有什么想法吗?谢谢!

1 个答案:

答案 0 :(得分:1)

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

  

您的文件DocBlock(您所指的那个)包含完整的解释;而您看到的文本是Class DocBlock(https://github.com/phpseclib/phpseclib/blob/master/phpseclib/Math/BigInteger.php#L174)。

     

此时,响应式模板仅显示Class DocBlock;文件尚未表示