1

たとえば、phpDocumentor、および任意の注釈パーサー (Doctrine common としましょう) によって解析される docblock コメントがあるとします。

<?php
/**
 * @author Blah <blah@example.com>
 * Class to handle the generation of lorem ipsum text for our templates
 * To declare as a service in the DIC, __uncomment__ the following annotation
 * @DIC\Service("textgenerator.loremipsum")
 */
 class LipsumGenerator implements TextGeneratorInterface { }

さて、ユーザーが解析を望ま@DIC\Serviceない限り、アノテーションをデフォルトで解析したくありません...明らかに、それを防ぐためにいくつものことを行うことができます:インラインではなくマニュアルページに保存し、非docblock コメントなど。注釈パーサーinlineに docblock 内の注釈を無視する

ように通知する、正しく比較的標準的な方法はありますか?

4

1 に答える 1

0

--ignore-tags 引数を試してください -- http://manual.phpdoc.org/HTMLSmartyConverter/HandS/phpDocumentor/tutorial_phpDocumentor.howto.pkg.html#using.command-line.ignore-tags

そのような注釈を無視する「永続的なリスト」を作成したい場合、最善の策は、phpDocumentor を実行するときに常に使用するカスタム構成ファイルです。構成ファイルを使用するすべての phpDocumentor 実行で無視される注釈タグのリストを作成できます。

http://manual.phpdoc.org/HTMLSmartyConverter/HandS/phpDocumentor/tutorial_phpDocumentor.howto.pkg.html#using.config-files

于 2012-07-31T19:29:09.747 に答える