XMLDoc und Helpinsight

[hansmaad]

Ich versuche mich gerade für einen Kommentarstil zu entscheiden und hab dabei zufällig entdeckt, dass Delphi ja auch XMLDoc Dateien generieren kann und den Inhalt auch teilweise im helpinsight anzeigt. Das Anzeigen funktioniert auch ganz gut, allerdings schainbar immer nur für den ersten Typ innerhalb einer Unit.

Delphi-Quellcode:

unit Unit1;

interface
type
    /// <summary>Aaaaffe</summary>
    Affe = class

    end;

    /// <summary>Baaanane</summary>
    Banana = class

    end;
implementation

end.

Affe wird mir angezeigt, Banane nicht. Lösche ich Affe, sehe ich auch Banane. Das gilt dann auch für alle Methodenkommentare von Banana. Mach ich was falsch oder ist das buggy?

[himitsu]

In meinem D2010 seh ich Beides.
(schade daß sowas nicht schon in der Autovervollständigung angezeigt wird)

Nee, stimmt, wenn das in einer externen/anderen Unit steht, dann zeigt es nur das Erste an.

Ist wohl wirklich ein Bug ... eventuell bricht der entsprechende Parser ja nach dem ersten Fund ab (durch einen nicht angezeigten Fehler).

In Delphi 2005 mußte man wohl das HelpInsight noch selber installieren (jedenfalls klingt das danach)
Wenn es da funktionierte ... vielleicht bekommt man es auch ins D2010 rein. :roll:

http://blog.marcocantu.com/blog/help_insight_xsl.html
http://edn.embarcadero.com/article/32770
http://delphi.wikia.com/wiki/Help_insight


PS: die anderen beiden, angeblich funktionierenden, Kommentartypen

Delphi-Quellcode:

{! ... *}

und

Delphi-Quellcode:

{*! ... *}

funktionieren garnicht.

[Jaynder]

schreib ein eigenes "type" vor Banana, dann gehts

Delphi-Quellcode:

unit Unit1;

interface
type
    /// <summary>Aaaaffe</summary>
    Affe = class

    end;

type
    /// <summary>Baaanane</summary>
    Banana = class

    end;
implementation

end.

kannst dann allerdings keine Vorwärtsreferenzen mehr definieren, ist also schon ziemlich blöd. Gibt auch noch eine andere Macke, s. mein Post http://www.delphipraxis.net/168316-n...ymbolbeschreib