не все в заголовке phpdoc отображается

Я пытаюсь создать документацию с помощью phpDocumentor (phpdoc -d . -t output) на Math_BigInteger от phpseclib, и у меня есть несколько вопросов. Вот заголовок:

/**
 * 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, чтобы увидеть внутренний текст в заголовке, но это тоже не работает. Вероятно, по той же причине.

Вот где я ожидаю его появления:

введите здесь описание изображения

Любые идеи? Спасибо!


person neubert    schedule 28.04.2013    source источник
comment
Ваше использование выглядит правильно, поэтому я думаю, что это ошибка. Вы можете сообщить об этом по адресу github.com/phpDocumentor/phpDocumentor2/issues.   -  person ashnazg    schedule 29.04.2013


Ответы (1)


Я опубликую ответ, который я дал, по адресу https://github.com/phpDocumentor/phpDocumentor2/issues/804#issuecomment-17437818.

Ваш File DocBlock (тот, на который вы ссылаетесь) содержит полное объяснение; в то время как текст, который вы видите, является классом DocBlock (https://github.com/phpseclib/phpseclib/blob/master/phpseclib/Math/BigInteger.php#L174).

На данный момент адаптивный шаблон отображает только класс DocBlock; файлы еще не представлены

person mvriel    schedule 04.05.2013