Требуется ли @package с пространствами имен PHP 5.3?

Question

Я перешел на PHP 5.3 и пространства имен. Похоже, что тег @package теперь избыточен и бесполезен.

Это все еще требуется phpDoc или я могу игнорировать этот тег сейчас?

Спасибо

Answer 1

Не требуется.

В последнем документе теперь говорится, что @package следует избегать, если вы используете пространство имен и вам не нужна другая структура для документации:

Если по всем направлениям логические и функциональные подразделения равны, НЕ РЕКОМЕНДУЕТСЯ использовать тег @package, чтобы избежать накладных расходов на обслуживание.

http://phpdoc.org/docs/latest/references/phpdoc/tags/package.html

Answer 2

Пакет

@ относится не к пространствам имен, а к организации итоговой документации.

Пакеты используются для логической группировки связанных элементов. Руководство по phpDoc

РЕДАКТИРОВАТЬ :

Есть ли замена для PHPDocumentor, поддерживающая PHP 5.3?