Seite 5 von 8
Re: Documentation Comment
Verfasst: 19.07.2019 20:00
von Sicro
@RSBasic:
Ich glaube, @MenschMarkus meint deine XML-Tags, nicht die PB-Schlüsselwörter.
soll automatisch ergänzt werden zu:
@MenschMarkus:
Ist das Erstellen eines Templates in der PB-IDE keine Option für dich (Tools => Templates)?
Code: Alles auswählen
;<comment>
; <summary></summary>
; <param></param>
; <return></return>
; <example></example>
;</comment>
Wenn mehrere Parameter vorhanden sind, kannst du die Parameter-Zeile schnell mit
Strg + D verdoppeln.
Re: Documentation Comment
Verfasst: 19.07.2019 21:44
von MenschMarkus
Sicro hat geschrieben:@RSBasic:
Ich glaube, @MenschMarkus meint deine XML-Tags, nicht die PB-Schlüsselwörter.
soll automatisch ergänzt werden zu:
@MenschMarkus:
Ist das Erstellen eines Templates in der PB-IDE keine Option für dich (Tools => Templates)?
Code: Alles auswählen
;<comment>
; <summary></summary>
; <param></param>
; <return></return>
; <example></example>
;</comment>
Wenn mehrere Parameter vorhanden sind, kannst du die Parameter-Zeile schnell mit
Strg + D verdoppeln.
Noch besser...[THUMBS UP SIGN].
Re: Documentation Comment
Verfasst: 19.07.2019 22:58
von Sicro
MenschMarkus hat geschrieben:Noch besser...[THUMBS UP SIGN].
Noch ein Vorschlag:
Befindet sich der Textcursor innerhalb
und es wird eine festgelegte Tastenkombination gedrückt, wird das Tool z. B. mit dem Parameter
--auto-comment nochmal separat gestartet und erstellt automatisch einen vorausgefüllten Dokumentationskommentar:
Code: Alles auswählen
;<comment>
; <summary></summary>
; <param>List items(): </param>
; <param>itemText$: </param>
; <param>itemFlags: </param>
; <return></return>
; <example></example>
;</comment>
Procedure AddItem(List items(), itemText$, itemFlags)
Re: Documentation Comment
Verfasst: 19.07.2019 23:43
von MenschMarkus
Sicro hat geschrieben:und es wird eine festgelegte Tastenkombination gedrückt, wird das Tool z. B. mit dem Parameter --auto-comment nochmal separat gestartet und erstellt automatisch einen vorausgefüllten Dokumentationskommentar:
Code: Alles auswählen
;<comment>
; <summary></summary>
; <param>List items(): </param>
; <param>itemText$: </param>
; <param>itemFlags: </param>
; <return></return>
; <example></example>
;</comment>
Procedure AddItem(List items(), itemText$, itemFlags)
Ja, gute Idee, ABER
funktioniert nur "einfach", wenn ich eine Prozedur neu schreibe.
Ändere ich eine bestehende Prozedur für die schon eine Dokumentation existiert, wird es schon aufwändig den Kommentar durchzuarbeiten und z.B. nur einen neuen Parameter an passender Stelle einzufügen.
Also Aufwändig für RSBasic, nicht für den Anwender
Re: Documentation Comment
Verfasst: 20.07.2019 10:53
von Sicro
MenschMarkus hat geschrieben:funktioniert nur "einfach", wenn ich eine Prozedur neu schreibe.
Ändere ich eine bestehende Prozedur für die schon eine Dokumentation existiert, wird es schon aufwändig den Kommentar durchzuarbeiten
Ja, bestehende Dokumentationskommentare zu aktualisieren ist zu aufwendig. Wenn bereits ein Dokumentationskommentar besteht, sollte das Tool den Vorgang abbrechen.
Re: Documentation Comment
Verfasst: 21.07.2019 10:13
von STARGÅTE
Hallo RSBasic,
irgendwie bin ich zu blöd dein schönes Tool zu bedienen.
Dein Tool arbeitet richtig, wenn die Datei nicht in einem Projekt ist.
Hängt die Datei in einem Projekt, wird kein Kommentarfester mehr angezeigt
(Als ob Projekt-Tabs nicht mehr geparst werden)
Irgendwelche Ideen?
Re: Documentation Comment
Verfasst: 21.07.2019 11:10
von RSBasic
Guten Morgen STARGÅTE,
du hast eine PN bekommen.
Re: Documentation Comment
Verfasst: 24.07.2019 13:02
von MenschMarkus
Hat mir ja keine Ruhe gelassen.
Für den Anfrang mal ein mini Templategenerator.
Datei Compilieren und speichern
Ausführbare Datei in PB unter Werkzeuge einbinden und mit beliebiger Tastenkombination verknüpfen
Nach Aufruf der Tastenkombination mit Strg+V das Template an aktuellen Cursorposition einfügen
Code: Alles auswählen
; ====================================
; Comment Addon
; Author : menschmarkus
; Date : 24.07.2019
; PB : PB 5.70 LTS (x86)
; Licence: zur freien Verwendung
; ohne Gewährleistung auf Funktion
; ====================================
Procedure CommentAddon()
Protected Query.s, found.i=0, addondir.s, filelen.i
;{ ===== Temporäres Verzeichnis ermitteln, ggf. erzeugen =====
If ExamineEnvironmentVariables()
While NextEnvironmentVariable()
If EnvironmentVariableName() = "TEMP"
Query = EnvironmentVariableValue()
found = 1
Break
EndIf
Wend
EndIf
If found = 0
MessageRequester("Fehler","Konnte temporäres Verzeichnis nicht finden",#MB_ICONERROR)
End
EndIf
;}
;{ ===== Addon Verzeichnis ermitteln, ggf. erzeugen =====
found = 0
addondir = Query
SetCurrentDirectory(addondir)
If ExamineDirectory(0,addondir,"")
While NextDirectoryEntry(0)
Select DirectoryEntryType(0)
Case 2
If DirectoryEntryName(0) = "PB_Addon"
found = 1
addondir + "\PB_Addon"
SetCurrentDirectory(addondir)
Break
EndIf
EndSelect
Wend
EndIf
FinishDirectory(0)
;}
;{ ===== Addon Verzeichnis erzeugen falls nicht vorhanden.
; Falls nicht vorhanden, Basisdatei erstellen.
; Falls vorhanden, Basisdatei einlesen =====
If found = 0
addondir + "\PB_Addon"
If CreateDirectory(addondir)
SetCurrentDirectory(addondir)
If CreateFile(0,"comment.addon")
WriteStringN(0,";<comment>")
WriteStringN(0,"; <summary></summary>")
WriteStringN(0,"; <param></param>")
WriteStringN(0,"; <return></return>")
WriteStringN(0,"; <example></example>")
WriteStringN(0,";</comment>")
CloseFile(0)
EndIf
EndIf
Else
ReadFile(0,addondir + "\comment.addon")
filelen = Lof(0)
SetClipboardText(ReadString(0,#PB_File_IgnoreEOL,filelen))
CloseFile(0)
EndIf
;}
EndProcedure
CommentAddon()
Ach ja, im Temp Verzeichnis kann die Datei "comment,addon" auch manuell nach eigenem Ermessen nachträglich editiert werden
Viel Vergnügen damit
Re: Documentation Comment
Verfasst: 30.07.2019 20:16
von RSBasic
Documentation Comment 1.0.7 wurde veröffentlicht.
Changelog:
Re: Documentation Comment
Verfasst: 24.08.2019 15:30
von HeX0R
Ich hab
hier mal was Kleines gebastelt.
Ach ja @RSBasic:
Kannst Du bei Gelegenheit die Ausrichtung bei mehrzeiligen param Angaben anpassen?