Почему phpDocumentor не подхватывает документацию в файле?

Question

[Карл Майнхофф]

Написал тут документацию к своему велосипеду, решил собрать. Собираю и получаю вот такую магию:

Parsing /home/kkremen/PhpstormProjects/intranet-core/core/module/common-module.php
  No summary for method __construct()
  No summary for method __destruct()
  No summary for method newConfigReader()
  No summary for method newConfigWriter()
  No summary for method openDBTable()
  No summary for method openResource()
  No summary for method loadView()
  No summary for method newSession()
  No summary for method newCookieReader()

Триста раз проверил этот гребаный файл - все в порядке, комменты стоят - а документор все равно плюется. Кто-нибудь сталкивался, знает, что ему надо?

UPD: pastebin.com/zU2hwCWy - ссылка на сам файлик

Answer 1

[Алексей Немиро]

/**
 * @see CommonModule::onLoad()
 * CommonModule constructor. 
* You can not change the constructor directly, but you can use onLoad function instead.
 */
final function __construct()

Указывать @see перед описанием (summary) неправильно.

https://www.phpdoc.org/docs/latest/guides/docblock...


Нужно изменить порядок, сначала должно идти summary, затем может идти description и только потом tags (@see - относится к tags):

/**
 * CommonModule constructor. 
 * You can not change the constructor directly, but you can use onLoad function instead.
 *
 * @see CommonModule::onLoad()
 */
final function __construct()