phpDocumentor @пример использования

Кажется, я не могу понять, как заставить теги PHPCocumentor2 @example работать правильно.

Я пытаюсь проанализировать один файл. Мой рабочий каталог /home/developers/domains/example.com, и я пытаюсь проанализировать (относительно моего рабочего каталога) simplesamlphp/modules/example/lib/Auth/Process/RoleTrigger.php. Этот файл класса содержит документ, который выглядит следующим образом:

/**
 * Trigger Role on User from Configuration.
 *
 * @example "RoleManager.usage.example.php" Test Example
 */
public function process() { /* ... */ }

Когда я запускаю команду для разбора только этого файла с максимальной подробностью (phpdoc -f simplesamlphp/modules/example/lib/Auth/Process/RoleTrigger.php -t httpdocs/test -vvv) PHPDoc указывает, что текущий корневой каталог проекта /home/developers/domains/example.com/simplesamlphp/modules/example/lib/Auth/Process/, поэтому, согласно документации, это указывает, что файл примера RoleManager.usage.example.php должен находиться либо на том же уровне каталога анализируемого файла, либо в каталоге examples текущего корневого каталога проекта (который будет /home/developers/domains/example.com/simplesamlphp/modules/example/lib/Auth/Process/examples/).

Однако, как бы я ни старался, я, похоже, не могу заставить пример отображаться в сгенерированной документации.

Все, что я, кажется, получаю, это в правой части сгенерированной страницы:

Tags
example     Test Example

Без гиперссылки, или отображения содержимого файла, или чего-либо еще. Просто "Описание" ни с чем другим.

Я попытался использовать <code>, но несколько строк с несколькими уровнями отображают неработающий html, который также бесполезен:

Это:

/**
 * Test Doc
 *
 * <code>
 * <?php
 * $array = array(
 *     1 => 'one',
 *     2 => 'two',
 * );
 * print_r($array);
 * ?>
 * </code>
 */

Отображает следующий HTML-код:

<p><code>
&lt;?php
$array = array(</p>
<pre><code>1 =&gt; 'one',
2 =&gt; 'two',</code></pre>
<p>);
print_r($array);
?>
</code></p>

Несколько вложенных <code> и <pre> тегов, которые отображают что-то ужасное. Но это уже другой вопрос.