XML-Dateien von BDS2006

[Luckie]

Was sind das eigentlich für XML-Dateien, die das BDS2006 für jede Unit anlegt?

[Ghostwalker]

Hmm..hab zwar nur die Turbo-Variante, aber das sollte ja im wesentlichen das gleiche sein.

Bei mir legt er Standardmäßig keine XML-Dateien an. Kann es sein das du Modelling-Support drinn hast ? :) Da legt er nämlich XML-Dateien an :)

[Muetze1]

Zitat:

Zitat von Ghostwalker

Bei mir legt er Standardmäßig keine XML-Dateien an. Kann es sein das du Modelling-Support drinn hast ? :) Da legt er nämlich XML-Dateien an :)

Oder er meint die Projekte (.bdsproj) welche intern eine XML Struktur hat...

[Luckie]

Nein, nein, nein. Ich meine schon XML-Dateien, die auch diese Änderung haben. Aber ich sehe gerade, dass macht nur das BDS2006 bei mir zu Hause, an der Arbeit werden sie nicht angelegt. :gruebel:

[Assertor]

Hi Luckie,

Zitat:

Zitat von Luckie

Was sind das eigentlich für XML-Dateien, die das BDS2006 für jede Unit anlegt?

Das sind aber nicht die Dokumentationen, oder?

Projekteigenschaften -> Compiler -> Dokumentation "XML-Dokumentation erzeugen" angehakt?

Das war mal bei mir auch an und schon hatte ich für jede .pas eine .xml dabei...

Gruß winkel79

[Luckie]

Doch das war es. Und was kann man nun mit diesen Dokumentationen im XML-Format anfangen?

[mkinzler]

Man kann sich eine Dokumentation in HTML-Form erzeugen lassen

[Meflin]

Hier mal ein Auszug aus der Delphi-Hilfe ;)

Zitat:

XML-Dokumentation erzeugen
Verarbeitet Dokumentationskommentare im Quelltext und erzeugt in dem Verzeichnis mit der Projektdatei (.bdsproj) eine XML-Datei namens ProjectDoc.xml.

Zeilen, die mit /// beginnen und vor einem benutzerdefinierten Typ (wie einer Klasse, einem Delegate oder einer Schnittstelle) oder vor einem Element (wie einem Feld, einem Ereignis, einer Eigenschaft, einer Methode) oder einer Namespace-Deklaration stehen, können als Kommentare verarbeitet und in die Datei eingefügt werden..

Wenn Inkrementelles Build aktiviert ist, wird die Option XML-Dokumentation erzeugen ignoriert.

Diese Option entspricht der Compileroption /doc.

D.h.: Diese Dokumentationsdateien nützen dir auch nur was, wenn du deinen Code den Vorgaben entsprechend kommentierst. Dann hast du beim Kompilieren praktisch schon eine komplette Dokumentation für dein Projekt. Denn die enthält dann das was du in deinen code-Kommentaren angibst. Machst du das nicht, dürfte diese Dokumentationsdatei auch wenig hilfreich sein.

Damit kannst du machen was du willst. XML ist ja flexibel einsetzbar (z.B. via PHP auslesbar)...

[Luckie]

Ah, danke. Hm, mal sehen, ob das brauchbar ist.

[mkinzler]

Es wird hierzu aber nicht nur der Code sondern auch die UML-Diagramme, welche erfasst wurden, herangezogen.

[Khabarakh]

Das ist das Format der .Net-XML-Kommentare, die sich mit Tools wie Microsoft Sandcastle zu ziemlich hüpschen Hilfen im Stile des SDKs konvertieren lassen. Die XML-Datei allein wird von den IDEs für IntelliSense herangezogen. Das Ganze wurde also wahrscheinlich von Delphi.Net nach Win32 übertragen, wie es auch der gepostete Hilfeeintrag nahelegt. Unter Delphi 2005 habe ich den Konverter von Borland jedenfalls nicht zum Laufen gebracht :stupid: . Und ich war nicht allein mit meiner Erfahrung, im Forum und QualityCentral sollten sich weitere Berichte über missglückte Versuche finden.