Могу ли я использовать дважды «@subpackage» для phpDocumentor?

Question

Например, у меня есть проект с именем «myproj» и подпакет с именем «utils», и в этом подпакете снова есть подпакет с именем «debug».

Могу ли я сделать что-то подобное:?

/**
  * @package myproj
  * @subpackage utils
  * @subpackage debug
  * /

Заранее спасибо!

---

Решение

Также есть тег @category:

Тег @category используется для организации групп пакетов вместе.

Таким образом, вы можете использовать теги в следующем порядке: @category, @package, @subpackage И если этого вам недостаточно, можете использовать также подчеркивания в именах.

Answer 1

Я знаю, что вопрос довольно старый, но для любых спидеров Google - @subpackage теги теперь устарели .Вместо этого используйте тег @package следующим образом:

@package [level 1]\[level 2]\[etc.]

Проверьте руководство по PHPDocumentor2: http://www.phpdoc.org/docs/latest/for-users/phpdoc/tags/package.html

Answer 2

Большинство генераторов не будут понимать несколько тегов подпакетов.Конвенция должна использовать подчеркивание или дефис;или не сегментирование ниже 2 уровня (пакет / подпакет)

См .: http://manual.phpdoc.org/HTMLSmartyConverter/HandS/phpDocumentor/tutorial_tags.subpackage.pkg.html