Verbesserungen an der Dokumentation für PureBasic v4

Fragen und Bugreports zur PureBasic 4.0-Beta.
Benutzeravatar
Andre
PureBasic Team
Beiträge: 1754
Registriert: 11.09.2004 16:35
Computerausstattung: MacBook Core2Duo mit MacOS 10.6.8
Lenovo Y50 i7 mit Windows 10
Wohnort: Saxony / Deutscheinsiedel
Kontaktdaten:

Beitrag von Andre »

Habe die Vorschläge aus diesem Thread eben wie folgt umgesetzt:

- ToolBarStandardButton() : #PB_ToolBarIcon_PrintPreview hinzugefügt
- Add3DArchive(): ich sehe hier nirgends, dass da überhaupt ein (gültiger) Rückgabewert vorhanden/nötig wäre => nicht umgesetzt (es sei denn, freak meint da mal noch etwas anderes dazu)
- CheckFileName() : korrigiert
- SetCurrentDirectory() : keine Änderungen vorgenommen (warum, hat ja freak schon geschrieben)
- Floats/Doubles: Information zum Wertebereich in die ergänzenden Erläuterungen aufgenommen
- Swap : Beschreibung in Klammern leicht geändert
- SortStructuredList() : korrigiert + Reihenfolge geändert

Werde mich gelegentlich auch noch über den alten Thread hermachen, und die (eindeutig erkennbaren und richtigen) Anregungen in die Hilfe einfließen lassen.

Veröffentlichung des ganzen mit der nächsten PB-Version.
Bye,
...André
(PureBasicTeam::Docs - PureArea.net | Bestellen:: PureBasic | PureVisionXP)
Benutzeravatar
Andre
PureBasic Team
Beiträge: 1754
Registriert: 11.09.2004 16:35
Computerausstattung: MacBook Core2Duo mit MacOS 10.6.8
Lenovo Y50 i7 mit Windows 10
Wohnort: Saxony / Deutscheinsiedel
Kontaktdaten:

Beitrag von Andre »

Aus dem alten Thread habe ich vorerst folgende weitere Hinweise umgesetzt:
Changes for english + german docs:
- DisplaySprite3D(): made Transparency as optional parameter -> the description must be updated too! (what is the standard value?)
- Preference lib: added a note, that using unicode forces to write preference files in UTF-8 format
- StructureUnion: added a note, that each field must be of a different type
Werde mich nun noch weiter durch diesen Thread rückwärts durchkämpfen, allerdings nicht mehr heute... :wink:
Bye,
...André
(PureBasicTeam::Docs - PureArea.net | Bestellen:: PureBasic | PureVisionXP)
Little John

Beitrag von Little John »

ReadProgramString() hat geschrieben:Liest eine Zeile von der Fehlerausgabe (stdout) des angegebenen Programms.
Nur eines von beiden kann zutreffen, entweder Fehlerausgabe (= stderr) oder Standardausgabe (= stdout).

Gruß, Little John
Little John

Beitrag von Little John »

Deutsche Hilfe zu PB 4.10 beta 2 hat geschrieben:Prozeduren
--------------
Eine Prozedur kann wenn nötig ein Ergebnis (Variable, String) zurückliefern.
Eine Variable kann auch ein String sein und umgekehrt. Außerdem kann eine Prozedur
z.B. eine konstante Zahl zurückliefern. Weiterhin sollte m.E. deutlich gemacht werden,
was ProcedureReturn nicht zurückliefern kann. Daher schlage ich etwa folgenden Text
vor:
neu:
Eine Prozedur kann wenn nötig eine Zahl oder einen String zurückliefern.

wie bisher:
Sie müssen in diesem Fall nach Procedure den Typ (.Typ) festlegen und das ProcedureReturn
Schlüsselwort an einem beliebigen Punkt innerhalb der Prozedur aufrufen. Ein Aufruf von
ProcedureReturn verlässt umgehend die Prozedur, auch wenn er innerhalb einer Schleife erfolgt.

neu:
Um ein Array oder eine Linked List zurückzuliefern, kann ProcedureReturn nicht verwendet werden.
Übergeben Sie zu diesem Zweck das Array oder die Linked List als Parameter an die Prozedur.
Gruß, Little John
Zuletzt geändert von Little John am 04.07.2007 15:06, insgesamt 1-mal geändert.
Benutzeravatar
AND51
Beiträge: 5220
Registriert: 01.10.2005 13:15

Beitrag von AND51 »

XMLNodeFromPath() hat geschrieben:"childtag\subchildtag[3]" definiert den dritten "subchildtag" innerhalb des ersten "childtag" vom '*ElternKnoten'.
Falsch, hier muss \ durch / ersetzt werden.
PB 4.30

Code: Alles auswählen

Macro Happy
 ;-)
EndMacro

Happy End
Benutzeravatar
Lebostein
Beiträge: 674
Registriert: 13.09.2004 11:31
Wohnort: Erzgebirge

Beitrag von Lebostein »

In dem Hilfetext für ProgramParameter([index]) fehlt der Hinweis, das der Index des ersten Parameters 0 ist. PureBasic ist da etwas inkonsequent, was den Parameter index angeht. Bei StringField() zum Beispiel ist die erste Indexposition 1. Deshalb ist es wichtig, das immer dazuzuschreiben. Danke!
Little John

Beitrag von Little John »

Zufällig habe ich im Forum von der Funktion EventlParam() gelesen.
In der engl. Hilfe von PB 4.10 beta 2 ist diese Funktion zwar in
der History erwähnt, aber sonst habe ich nichts über sie gefunden!
Das gleiche gilt für EventwParam().

Gruß, Little John
Benutzeravatar
D@nte
Beiträge: 324
Registriert: 24.04.2007 15:33
Wohnort: Berlin

Beitrag von D@nte »

aus'em englischen Forum
Andre hat geschrieben:
va!n hat geschrieben: EventlParam()
EventwParam()
ListCount()
EventlParam() and EventwParam() are still no official supported commands. Because of this also not documented in the help file, until Fred change this...
Benutzeravatar
PureLust
Beiträge: 1145
Registriert: 21.07.2005 00:02
Computerausstattung: Hab aktuell im Grunde nur noch 'nen Lenovo Yoga 2 Pro im Einsatz.
Wohnort: am schönen Niederrhein

Beitrag von PureLust »

Die Beschreibung zu der Konstanten #PB_Window_Minimize bei OpenWindow() ist fehlerhaft bzw. die Konstante hat nicht den beschriebenen Effekt.

(Siehe dazu auch den >Thread< im englischen Forum.)
[Dynamic-Dialogs] - komplexe dynamische GUIs einfach erstellen
[DeFlicker] - Fenster flimmerfrei resizen
[WinFX] - Window Effekte (inkl. 'durchklickbares' Window)
Benutzeravatar
Andre
PureBasic Team
Beiträge: 1754
Registriert: 11.09.2004 16:35
Computerausstattung: MacBook Core2Duo mit MacOS 10.6.8
Lenovo Y50 i7 mit Windows 10
Wohnort: Saxony / Deutscheinsiedel
Kontaktdaten:

Beitrag von Andre »

Habe neben der Übersetzung der ganzen neuen Dinge von PB v4.10 auch noch die Anregungen aus diesem Thread umgesetzt:

- SetWindowCallback() : lauffähiges Beispiel hinzugefügt
- ReadProgramString() : Beschreibung korrigiert
- ProcedureReturn : Beschreibung des Rückgabewertes verbessert
- XMLNodeFromPath() : falsches \ korrigiert
- ProgramParameter() : Hinweis zum Index beginnend bei 0 aufgenommen
- noch paar Rechtschreibfehler korrigiert

Mehr von diesen Verbesserungen demnächst. Auch eine Veröffentlichung der Hilfe erfolgt dann auf www.PureArea.net

Anmerkung: #PB_Window_Minimize - hier gibt es nichts in der Hilfe zu verbessern. Das nicht minimierte Öffnen des Fensters war ein Bug und wurde von freak bereits als "fixed" gemeldet.
Bye,
...André
(PureBasicTeam::Docs - PureArea.net | Bestellen:: PureBasic | PureVisionXP)
Gesperrt