phpdoc aktualisiert nicht meine Dokumentation

Question

phpDocumentor v1.4.4 Fedora 24

Befehlszeile: phpdoc -d ./docsrc -t ./output

Ich bin mit phpDocumentor auf Fedora 24 und haben erfolgreich generierte Dokumentation für mein Projekt einmal.

Ich habe einen Docblock zu einer Funktion hinzugefügt und phpdoc erneut ausgeführt. Aber die Ausgabe wurde nicht aktualisiert. Ich habe die Zeitstempel der Dateien überprüft und sie wurden neu generiert, spiegeln jedoch nicht die Änderungen wider.

Ich habe nachträglich zahlreiche Änderungen vorgenommen, und phpdoc nach jeder Änderung reran, aber die generierte Dokumentation wird nicht aktualisiert.

Ich habe alle Ausgabedateien gelöscht, das Verzeichnis der Eingabedateien umbenannt, kurz gesagt habe ich alles getan, um phpdoc zu überzeugen, neue Dokumentation zu erzeugen, die die Änderungen meiner PHP-Dateien vergeblich widerspiegelt.

Es scheint, dass phpdoc die Ausgabe irgendwo zwischenspeichert, aber ich kann nicht wo finden. Ich suchte jeden Pfad auf meiner Festplatte, der phpdoc enthielt, suchte dann in jedem Pfad nach dem Wort "Cache", aber es trat nicht auf.

Ich habe versucht, die Vorlage mit der Anweisung --template zu ändern, aber diese Anweisung wird nicht erkannt.

Ich habe versucht mit der --force-Direktive, aber es erkennt diese Direktive nicht an.

Kann mich jemand aufklären?

Cheers, Peter

Answer 1

Das klingt wie eine jener Zeiten, wo ich durch den Prozess nur von Anfang an gehen würde:

• Bin ich in dem ./docsrc Verzeichnisbaum zu modifizieren Quelle? Überprüfen Sie, indem Sie das Quellelement in /vim/nano/irgendeinen anderen Editor öffnen, nur um sicher zu sein, dass sich die Quelle geändert hat.
• Habe ich die Quelle mit der richtigen Syntax geändert? (Bitte senden Sie einen Code, der Dokumentation anzeigt, die nicht aktualisiert wird)
• Ändern Sie Dokumentation in einer anderen Datei mit einer einfachen Änderung, und sehen Sie, ob diese einfache Änderung angezeigt wird, wenn ich meine Dokumentation neu generiere.
• Bin ich explizit --ignore -die Datei oder das Verzeichnis, das ich erwarte zu ändern? (Sie scheinen nicht zu sein)
• Ich habe eine phpdoc.xml oder phpdoc.dist.xml Datei mit einer <ignore> Direktive? details
• Verfüge ich über die erforderlichen Berechtigungen zum Erstellen/Aktualisieren von Dateien im Verzeichnis ./output?
• Nachdem ich ausgeführt habe phpdoc -d ./docsrc -t ./output sehe ich die erwartete Änderung, wenn Sie vi/vim/nano/irgendeinen anderen Editor verwenden?
• Speichert mein Browser frühere Versionen der Dokumentation?(Ich weiß, du hast das schon ausgeschlossen. Peter, ich versuche nur, meine Antwort vollständig zu machen)