Quelltext formatieren [Strg-D], Kommentare ausschliessen

[norwegen60]

Hallo,

weiß jemand ob es eine Möglichkeit gibt Kommentar von der Autoformatierung auszuschliessen? Wenn ich folgende Kommentare habe

Delphi-Quellcode:

{+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
Header

================================================================================
Funktionen
  SetBit      = Setzt das Bit an einer bestimmten Stelle einer Integerzahl.
                  i:=SetBit(5,2,True) => i:=7
  StrAnz      = Ermittelt in einem String die Anzahl eines anderen Strings
                  B:=StrAnz('l','Alles klar'); => B=3
+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++}

und per [Strg-D] die Autoformatierung durchführe, sieht der Kommentar so aus

Delphi-Quellcode:

{+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
  Header

  ================================================================================
  Funktionen
  SetBit      = Setzt das Bit an einer bestimmten Stelle einer Integerzahl.
  i:=SetBit(5,2,True) => i:=7
  StrAnz      = Ermittelt in einem String die Anzahl eines anderen Strings
  B:=StrAnz('l','Alles klar'); => B=3
  +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ }

Also nicht gerade besser lesbar
Es geht nicht nur um die Erklärung von Funktionen die man vielleicht auch per Headerformate erklären könnte sondern um alle Arten von Kommentare.

Danke
Gerd

[DeddyH]

"Tools - Optionen - Formatierung - Delphi - Einzug - Allgemein - Kommentare einziehen" auf Nein setzen.

[norwegen60]

Super. Danke. Ich hatte es mit Leerzeichen - Leerzeichen für Kommentare versucht, was nicht geklappt hat

[DeddyH]

Die Formatierungsoptionen sind auch nicht unbedingt übersichtlich

[himitsu]

Alternativ kannst du auch auf XMLDoc umsteigen. Es hat auch den Vorteil, dass diese Hilfe über's HelpInsight überall im Code verfügbar ist, also bei jedem Aufruf der Funktionen.
Der Documentation Insight Editor fehlt ja leider inzwischen wieder, aber die Grundfunktionen können immernoch verwendet werden.

Am Einfachsten man macht sich eigene Vorlagen (wenn man Documentation Insight nicht kaufen möchte), oder man macht es aus dem Kopf (gibt ja nur eine handvoll Typen), bzw. verwendet die unpraktischeren Codevorlagen vom Delphi.

[norwegen60]

Zitat von himitsu:

Alternativ kannst du auch auf XMLDoc umsteigen.

Ja, das ist ein anderes Thema. Es ging mir aber allgemein um Kommentare und da war die Kurzbeschreibung das erste was mir in die Finger kam.

[Aviator]

Zitat von himitsu:

Am Einfachsten man macht sich eigene Vorlagen (wenn man Documentation Insight nicht kaufen möchte), oder man macht es aus dem Kopf (gibt ja nur eine handvoll Typen), bzw. verwendet die unpraktischeren Codevorlagen vom Delphi.

Oder man installiert sich CnPack. Dort sind im Eingabehelfer die XML-Dok Kommentare enthalten und man kann die dann einfach übernehmen und muss sie nur noch ausfüllen.

[Uwe Raabe]

Zitat von Aviator:

Zitat von himitsu:

Am Einfachsten man macht sich eigene Vorlagen (wenn man Documentation Insight nicht kaufen möchte), oder man macht es aus dem Kopf (gibt ja nur eine handvoll Typen), bzw. verwendet die unpraktischeren Codevorlagen vom Delphi.

Oder man installiert sich CnPack. Dort sind im Eingabehelfer die XML-Dok Kommentare enthalten und man kann die dann einfach übernehmen und muss sie nur noch ausfüllen.

Die vorhandenen Bordmittel in Form der XMLDOC-Templates para, param, remarks, returns und summary reichen vielleicht auch für den Anfang.