Ich verwende die Documentum Insight-Funktion, um eine Delphi-Bibliothek zu dokumentieren. Dies funktioniert derzeit mit Delphi 2005 bis XE3. Jetzt möchte ich auch Unterstützung für alte Versionen von Delphi (5, 6, 7) hinzufügen.
Aber wenn Sie versuchen, einen Code wie diesen in Delphi-Versionen kleiner als 2005 zu kompilieren (Delphi 5, 6, 7)
%Vor%Ich erhalte einen Compilerfehler
Ungültige Compiler-Direktive REGION
Was ist in Ordnung, weil das REGION reservierte Wort eingeführt wurde, als die Delphi-IDE geändert wurde? Galileo (Delphi 2005).
Also, als Workaround verwende ich diese Syntax, um den Code in Delphi 5 zu XE3 zu kompilieren.
%Vor%Aber mit diesem Code funktioniert Documentation Insight in Delphi XE2 und XE3 nicht mehr.
Die Frage ist also, wie ich dokumentierten Delphi-Code in älteren Versionen von Delphi kompilieren kann, ohne die Dokumentation in den neueren Delphi-Versionen zu beeinflussen?
Wenn Sie die {$REGION} -Tags entfernen, funktioniert Document Insight weiterhin, und ältere Versionen sollten die Dokumentation als normale Kommentare behandeln. Sie werden die Dokumentation in IDE-Versionen, die Code-Faltung unterstützen, nicht mehr reduzieren können, das ist alles.
Wenn Sie eine Codebasis haben müssen, die ohne Änderungen in alten und neuen Delphi kompiliert, funktioniert diese Lösung nicht.
Es ist hässlich und müsste gemacht und rückgängig gemacht werden, wenn Sie von einer älteren Version von Delphi zu einer neueren Version wechseln.
Aber Sie könnten Ihr gesamtes Projekt hin und her pumpen.
Wenn Sie beispielsweise von XE2 zu D7 wechseln, würden Sie dies konvertieren
%Vor%durch Einfügen eines Leerzeichens und Entfernen des nachfolgenden} so sieht es so aus:
%Vor%Wenn Sie von D7 zu XE2 gehen, fügen Sie umgekehrt am Ende jeder Zeile, die mit
beginnt, ein} hinzu %Vor%und Entfernen des Leerzeichens nach dem $.
Wie ich schon sagte, es ist hässlich.
Documentation Insight unterstützt einige vordefinierte Regionenstile (siehe Dialogfeld Optionen). Sie können den Kompatiblen Stil wählen und automatisch Anweisungen wie {$ IFDEF NoDEF} {$ REGION 'xxx'} {$ ENDIF} generieren.
Tags und Links delphi documentation