
-------------------------------------------------------------------------
PBSourceConverter v1.1.0 - (C) 2006-2007 by Harald Wagner (AL90@arcor.de)
            Updates und Downloads auf http://www.purearea.net
-------------------------------------------------------------------------


Kurzanleitung:
--------------

Was ist der PBSourceConverter?
------------------------------

PBSourceConverter ist ein Plugin gesteuerter "Multi-Pass Converter" mit dem es mglich ist PurBasic-Sources
zu Konvertieren, um sie somit kompatibel zu neueren PureBasic-Compilern zu machen. Alternativ knnte man aber
auch zu lteren Compilern konvertieren. Dazu muss lediglich ein Plugin erstellt werden. In der original-
fassung beinhaltet der Konverter bereits das "PB394 zu PB400" Plugin.

Wie funktioniert das "Multi-Pass" System?
-----------------------------------------

Das Multi-Pass System ist eine ganz besondere funktion des Konverters. So ist es damit bspw. mglich einen
bestimmten Befehl mehrere male abzuarbeiten. (Konvertieren) Angenommen fr einen bestimmten Befehl ist es
erforderlich den Handle anstatt der ID zu ermitteln, so kann man in diesem fall den Konverter z.b. dazu bringen
erst ein '#PB_Any' an einem bestimmten Befehl anzuhngen, (Pass 1) whrend im nchsten durchlauf (Pass 2)
der Handle ermittelt, und im dritten durchlauf (Pass 3) das '#PB_Any' wieder entfernt wird. Insgesammt beinhaltet
der Konverter 6 Optionen fr die verschiedensten Konvertierungsauftrge. Kombiniert im zusammenhang mit der
Multi-Pass funktion sind die mglichkeiten somit nahezu unbegrenzt. Somit ist man auch fr zuknftige PureBasic-
Compiler bestens vorbereitet.

Was der Konverter nicht umsetzen kann.
--------------------------------------

Wenn der Konverter etwas nicht umsetzen kann, weil z.b. eine variable nicht ermittelt werden konnte,
dann trgt der Konverter stattdessen ein <value recognize failed> in dem entsprechendem Befehl ein.
Dies knnte dann z.b. so aussehen.:

WriteLong(<value recognize failed>,35)

Somit knnen Sie spter in der IDE einfach nach dem text <value recognize failed> mit F3 suchen, und finden
die entsprechenden stellen OHNE lstiges "Dauer-Compilieren" und Fehlergemelde des Compilers. Zudem sieht
man auch gleich viel besser wo der erforderliche Parameter eingetragen werden muss.

History:
--------

V1.0.0 - Erste Verffentlichung.

V1.0.1 - Eine Processbar wurde hinzugefgt.
       - Zum ermitteln der erforderlichen Parameter knnen nun mehrere Befehle eingegeben werden. (z.b. UseFile | ReadFile)
       - CommandLine untersttzung wurde hinzugefgt. ( <PluginName> <SourceFile> <DestFile> )
       - Die Konvertierung luft nun um einiges schneller.
       - Einige Fixes bei der erkennung der Befehle.

V1.0.2 - Einige Bugfixes im GUI.

V1.0.3 - Multi-Konvertierung wurde hinzugefgt.
       - Rekursives Including wird nun untersttzt.
       - PluginFile wurde erweitert.
       - Einige Fixes.

V1.0.4 - Includes werden nun separat gespeichert.
       - Einige Fixes.

V1.0.5 - Die krzel fr Includes knnen nun frei gewhlt werden.
       - Das Konvertieren von Includes kann nun auch deaktiviert werden.
       - Ein InfoText (;Converted on TT:MM:JJ) kann nun im Konvertierten Sourcecode eingefgt werden.
       - Einige Fixes.

V1.0.6 - Das Editieren eines Auftrages kann nun auch per Doppelklick erreicht werden.
       - Ein Bug bei der erkennung der Parameter wurde behoben.
       - Einige Fixes.

V1.0.7 - Die Anzahl der Konvertierungsauftrge werden nun im PluginEditor mit angezeigt.
       - Bei Konvertierung ber Kommandozeile wird nun ebenfalls eine Processbar angezeigt.
       - Einige nderungen in den GUI-Texten.
       - Einige Fixes.

V1.0.8 - Der Konvertierungsprozess kann nun auch mit der ENTER-Taste gestartet werden.
       - Das zuletzt benutzte Plugin wird nun ebenfalls mit in der Config gespeichert.
       - Ein eigenes Icon fr den Konverter wurde hinzugefgt.
       - Einige Fixes.

V1.0.9 - Einige Fixes bei der erkennung der Befehle. So wird jetzt beispielsweise "_ReadFile()"
         ordnungsgem als Funktion erkannt und nicht mehr mit konvertiert.

V1.1.0 - Fixed: Die 1MB grenze fr Quellcodes wurde aufgehoben.
       - Einige kleinere optimierungen.
       - Kompiliert unter PB4.10 fr Vista Kompatibilitt. (Nicht getestet)
