Tool zum Überprüfen von Dokumentation von Methoden

[Stevie]

Zitat von Der schöne Günther:

Zitat von Stevie:

Documentation Insight kanns nicht, das hab ich vorhin ausprobiert.

Ich verstehe nicht- Das ist doch im RAD Studio alles schon eingebaut? Und grade das baut doch auf Documentation Insight auf.

• Warnungen wenn ich einen Parameter nicht dokumentiert habe
• Wenn ich einen Parameter dokumentiere den es nicht (mehr) gibt
• Und vieles mehr

Siehe Bilder.


Einen "Babysitter" mit "Hey, du hast an der Implementation etwas verändert. Hast du denn auch schön die Doku angepasst?" kenne ich allerdings auch nicht.

Ich hab auf Validate Documentation geklickt und da hats mir nix ausgespuckt.
Wenn allerdings der Compiler solche Optionen hat, dann ist ja alles geritzt.

Edit: Gerade mal ausprobiert. Dazu muss man bei den Compiler Optionen "Generate XML documentation" anhaken. Leider bekommt man bei den Messages nicht die richtige Zeilennummer, was das ganze nahezu unbrauchbar macht.

[Der schöne Günther]

Zitat von Stevie:

Leider bekommt man bei den Messages nicht die richtige Zeilennummer, was das ganze nahezu unbrauchbar macht.

Es geht- Man hat immerhin den Methodennamen. Besser als nichts.

[Stevie]

Zitat von Der schöne Günther:

Besser als nichts.

Deshalb schrieb ich auch "nahezu" unbrauchbar

[Chemiker]

Hallo,

„Documentation Insight“ scheint es in der Prof.-Version von XE3 aber nicht zu geben. Von daher ist es für den Beitragsersteller irrelevant.

Bis bald
Chemiker

[Uwe Raabe]

Zitat von Chemiker:

„Documentation Insight“ scheint es in der Prof.-Version von XE3 aber nicht zu geben. Von daher ist es für den Beitragsersteller irrelevant.

In dem Fall kann er es aber immer noch käuflich erwerben.

[Der schöne Günther]

Zitat von Chemiker:

„Documentation Insight“ scheint es in der Prof.-Version von XE3 aber nicht zu geben.

Klar, von XE2-XE5 war es dabei.

[Chemiker]

Hallo,

Zitat:

Klar, von XE2-XE5 war es dabei.

Stimmt, aber in XE6 und XE7 ist es nicht mehr dabei, warum auch immer. Und es ist dann blöd, wenn man damit angefangen hat und es dann bei der nächsten Version wieder als Tool nicht zur Verfügung steht.


Bis bald
Chemiker

[Uwe Raabe]

Zitat von Chemiker:

Und es ist dann blöd, wenn man damit angefangen hat und es dann bei der nächsten Version wieder als Tool nicht zur Verfügung steht.

Aber es steht doch noch zur Verfügung - halt nicht mehr gratis. Das ist doch ein durchaus gängiges und legitimes Verfahren, ein neues Produkt erstmal durch Gratisabgabe schmackhaft machen und danach kostenpflichtig anzubieten. Dann kann ja jeder selbst entscheiden ob es einem den Preis wert ist. Selbst QuickReport (war als Standardversion gratis in D3 - D7 dabei) kann man heute noch für aktuelle Delphi-Versionen kaufen.