jaPBdoc

[#NULL]

@Thorsten
ja, siehe erster post von mir auf dieser seite.
<edit> typisch, ..jetzt ist es natürlich die seite vorher

<edit> @remi
der code compiliert doch. hatte es nur ausversehen und ohne zu wissen mit pb-beta probiert und bekam komische errors.
mit 4.10 geht's.

[#NULL]

ich hab noch 3 parameter hinzugefügt:

Code: Alles auswählen

/NoSortParam
/NoSortField
/NoSortPaFl

damit werden felder von strukuren, oder parameter von funktionen innerhalb der description nicht sortiert. (oder beides mit /NoSortPaFl, da das zulassen mehrerer parameter wahrscheinlich komplizierter ist)
[link entfernt]

[remi_meier]

Eigentlich musst du für mehrere Parameter nur unter
GetFileNameFromParameter()
und
ProcessCommentParameters()
die beiden eintragen, sowie für jeden Parameter eine Element zur globalen
Struktur GLOBALS hinzufügen. Dann natürlich im Programmablauf darauf
reagieren.
Ich muss zugeben, man könnte leicht beide Funktionen in eine kompaktere
Form bringen. Werde das ev. noch angehen.

[#NULL]

sehe ich das richtig, dass man für not/only-start nur einen string angeben kann? also..

Code: Alles auswählen

jaPBDoc.exe file.pb /notstart "*pointers"

? ich hab jetzt nämlich was gebaut, so dass man mehrere möglichkeiten angegeben kann:

Code: Alles auswählen

jaPBDoc.exe file.pb /notstart "*pointers;abc_;#abc_"

ich bin mir jetzt aber nicht sicher, ab das sowieso schon irgendwie ging.

außerdem weiß ich nicht, wie ich das noch in ProcessCommentParameters() einsetzen muß (not/only-start ist in der struktur jetzt jeweils ein array)

Code: Alles auswählen

Procedure GetFileNameFromParameter()
  Protected s.s, z.l, NextIs.l, i.l
  
  s = ProgramParameter()
  While s
    If NextIs = #StringNotStart
      For i=0 To CountString(s,";")
        glob\FilterNotStartWith[i] = Trim(LCase(StringField(s,i+1,";")))
      Next
      NextIs = 0
    ElseIf NextIs = #StringOnlyStart
      For i=0 To CountString(s,";")
        glob\FilterStartWith[i] = Trim(LCase(StringField(s,i+1,";")))
      Next
      NextIs = 0
    ElseIf LCase(s) = "/notstart"
      NextIs = #StringNotStart
    ElseIf LCase(s) = "/onlystart"
      NextIs = #StringOnlyStart
;[...]

<edit> oder sollte ich die lieber als flags belassen, und zusätzliche listen/arrays verwenden?

[remi_meier]

Hab die Änderung nun vorgenommen, aber noch nicht ausgiebig getestet.
Jetzt muss man Parameter nur noch in der Funktion ProcessProgramParameter()
eintragen. Modifiziert wurden nur GetFileNameFromParameter()
und
ProcessCommentParameters(), musst also nur diese beiden bei dir ersetzen
und die neue hinzufügen.
http://remi.secretly.de/downloads/linjaPBDoc.zip

Wegen /notstart etc. hast du das glaub richtig gesehen! Wo du aber ev. noch
aufpassen musst: IIRC sollte das Setzen der Flags/Optionen Dateiweise
geschehen. D. h. du musst, wenn du nun ein Array hast, zusätzlich innerhalb
von ProcessProgramParameter() die vorigen Werte, die darin schon gespeichert
sind, überschreiben, damit sie für jede Datei immer neu gesetzt werden können
und nicht die Optionen von den Dateien zuvor geerbt werden. (Das Setzen
Dateiweise funktioniert über die Kommentare)

Ich hoffe, es ist verständlich.

greetz
Remi

[#NULL]

ich brauchte hierfür ein update und habe meine eigenen änderungen mit der version aus remi's letzem post gemerged und noch was hinzugefügt.
außerdem läuft es jetzt mit pb 5.42

Code: Alles auswählen

----------------------------------------------
2016-29-04

- added support for 'NewMap' declarations
- fixed handling of declarations of array/lists/maps of pointers (both were working independently but not in combination)
- added paramters:
	/nosortparam
		Don't sort procedure arguments.
	/nosortfield
		Don't sort structure fields.
	/nosortpafl
		Don't sort procedure arguments and structure fields.
	/nosort
		Don't sort anything.
- added missing paramter documentation in ReadMe.html:
	/stylesheet
		The next parameter is a stylesheet filename that will be linked in the resulting html file.
- fixed missing removal of %STYLESHEET% placeholder in template if no stylesheet is specified

adapted code to PB 5.42:
- some function pointers now integer
- using Bool() where necessary
- using 'List' keyword in procedure declaration
- changed #PB_Sort_String to #PB_String
- changed an array name to 'array_' to not conflict with the new PB keyword 'Array'


known issue (probably with the lexer):
	Global  myFont = LoadFont(#PB_Any,"Arial",8)     ;* my font documentation
produces:
	myFont = LoadFont(#PB_Any

----------------------------------------------

man kann außerdem für /notstart und /onlystart jetzt auch mehrere patterns durch semikolons getrennt angeben.

DOWNLOAD: [link entfernt]

ich weiß grad nicht was mit den neuen keywords List/Array etc in procedure argument deklarationen passiert.. muß ich mir nochmal anschauen.

[#NULL]

Code: Alles auswählen

2016-30-04

- fixed problem with sources that do not contain structures/interfaces
- fixed problem if procedure calls are used for variable initialization
- added support for List/Array/Map keywords in procedure argument declarations

DOWNLOAD:
http://www.wannabephoenix.de/PB/jaPBDoc ... -04-30.zip