2017-01-29 18 views
0

のphpDocumentor V1.4.4 のFedora 24phpdocのは、私のドキュメント

コマンドライン更新されません:はphpdocを-d ./docsrc -t ./output

私はFedoraの24日には、phpDocumentorを実行していますし、成功したドキュメントを生成しています私のプロジェクトのために1回。

私は関数にdocblockを追加して、再びphpdocを実行しました。しかし、出力は更新されていません。私は、ファイルのタイムスタンプを確認し、それらは再生成されましたが、変更を反映しません。

その後、私は数多くの変更を加え、変更後にphpdocを適用しましたが、生成されたドキュメントは更新されません。

すべての出力ファイルを削除し、入力ファイルのディレクトリ名を変更しました。私のphpファイルの変更を反映した新しいドキュメントを生成するようにphpdocを説得することができました。

phpdocが出力をどこかにキャッシュしているように見えますが、どこに見つけることができません。私はphpdocを含むディスク上のすべてのパスを検索し、各パスで "cache"という単語を検索しましたが、それは起こりません。

テンプレートを--templateディレクティブで変更しようとしましたが、このディレクティブが認識されません。

私は--forceディレクティブを使用しようとしましたが、このディレクティブは認識しません。

誰かが私を啓発できますか?

乾杯、 ピーター

+0

ブラウザで生成されたPHPDocファイルを調べていますか?もしそうなら、ブラウザでキャッシュをクリアしましたか? –

+0

はいキャッシュをクリアしました。申し訳ありませんが、指定するのを忘れてしまいました。私はFirefoxとChromeの両方でも見てきました。私がブラウザを切り替えたとき、ファイルはキャッシュに入っていない可能性がありました。なぜなら、そのブラウザでは初めてのことでしたが、まだ古いphp docファイルが表示されていたからです。ブラウザのキャッシュについて確かに確か。 – Peter

答えて

0

これは私がちょうど最初からプロセスを歩くはずの時間のいずれかのように聞こえる:

  • は、私が./docsrcディレクトリツリー内のソースを変更するのですか? vi/vim/nano/some-other-editorのソースメンバーを開いて、ソースが変更されたことを確認してください。
  • 正しい構文を使用してソースを変更しましたか? (更新されていないドキュメントを示すコードを投稿してください)
  • ドキュメントを簡単な変更で別のファイルに変更し、ドキュメントを再生成するときにその単純な変更が表示されるかどうかを確認してください。
  • 明示的に--ignore-私が変更する予定のファイルまたはディレクトリですか? (表示されません)
  • phpdoc.xmlまたはphpdoc.dist.xmlファイルに<ignore>という指令がありますか? details
  • ./outputディレクトリにファイルを作成/更新するために必要な権限がありますか?
  • 実行した後vi/vim/nano/some-other-editorを使用すると予想される変更がありますか?
  • 私のブラウザは以前のバージョンのドキュメントをキャッシュしていますか?(私はあなたが既にこれをPeterから支配したことを知っています。私は答えを完全にしようとしています)
+0

あなたの長いと思いやりのある返事のためにベニーありがとう。現在のところ、問題は解決しています。理由は分かりません。上記の質問に関しては、それぞれの回答が正しい答えですので、簡潔にしてください。私は第2の質問/示唆のためのいくつかのコードと結果を提供することに決めました。私は単一の1行の関数とdocブロックを持つ小さなPHPファイルを作成しました。私はdocを生成し、コメントを修正し、docとprestoを再生成しました!出来た。その後、元のディレクトリに戻って、何が起きているのかを確認し、すべてのドキュメントを再生成していました。 – Peter

+0

私はなぜそれがわかりません。すべてのWordPress用にdocを作成しないようにするには、自分のソースをphpdoc用の別のディレクトリにコピーしました。変更後に再コピーするのを忘れるほど厚くてもいいですか?私は何度かコピーを思い出します。私は決して知らないだろうと思う。どんなイベントでも、優れたチェックリストのおかげで、今後も役に立つと確かに証明されます。 – Peter

+0

@Peter - excellent!うれしい今それは働いている。ハッピーコーディング! –

関連する問題