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


QuickGuide:
-----------

What is the PBSourceConverter?
------------------------------

PBSourceConverter is a Plugin based "Multi-Pass Converter" with it you can converting PurBasic-Sources.
So you can make a compatible Sourcecode for a new PureBasic-Compiler. As alternative you can also make
compatible Sourcecodes to previously versions of PureBasic. So you must only create an own PluginFile for it.
The current version of Converter contains already the Plugin "PB394 to PB400".

How works the "Multi-Pass" System?
----------------------------------

The multi-pass system is a quite special function of the converter. So you can e.g. any basic-commands
converting multiple. For Example: You want get the Handle (not the ID) of a command. So you can e.g.
set firstly a '#PB_Any' on Position-1 to a command (Pass 1). Now you can get the Handle (Pass 2) and
then to last remove the '#PB_Any' again from command. The Converter contains 6 Options for creating
any converting-jobs. In combination with the Multi-Pass function are the possibilities near unlimited.
Therefore the converter is prepared very well also for future PureBasic compilers.

What the Converter cannot convert.
----------------------------------

If the converter cannot convert any parameters, e.g. because it cannot get a variable,
then the converter will insert a <value recognize failed> in the command.
This can be view so for example:

WriteLong(<value recognize failed>,35)

So you can later search and find the string <value recognize failed> with F3 in the IDE
without Error-Messages from the Compiler, because multiple compiling is not required.
In addition you can better see where the required parameter must be insert.


History:
--------

V1.0.0 - First Release.

V1.0.1 - Added a Processbar.
       - For get the required parameters can you now insert more commands. (e.g. UseFile | ReadFile)
       - Added CommandLine support. ( <PluginName> <SourceFile> <DestFile> )
       - Some Speedup in Converting-process.
       - Some Fixes in recognize of commands.

V1.0.2 - Some Bugfixes in GUI.

V1.0.3 - Added Multi-Converting.
       - Added Recursive Including support.
       - Added some entrys in PluginFile.
       - Some Fixes.

V1.0.4 - Includes will now save separate.
       - Some Fixes.

V1.0.5 - The Extension for Includes is now selectable.
       - Convert of Includes can now enable or disable.
       - A InfoText (;Converted on DD:MM:YY) can now insert in converted Sourcecode.
       - Some Fixes.

V1.0.6 - Added support for DoubleClick in Edit-Jobs Panel.
       - A Bug was fixed in recognize of parameters.
       - Some Fixes.

V1.0.7 - The Number of ConvertingJobs will now displayed in PluginEditor.
       - Conversion over CommandLine will now shown also a Processbar.
       - Some changes in GUI-Text.
       - Some Fixes.

V1.0.8 - Conversions can now start also with the ENTER-Key.
       - The last used Plugin will now also saved in ConfigFile.
       - Added an own Icon for the Konverter.
       - Some Fixes.

V1.0.9 - Some Fixes in recognize of commands. So will now e.g. "_ReadFile()"
         no longer converted but recognize as function.

V1.1.0 - Fixed: The 1MB limitation for sourcecodes was now removed.
       - Some small optimizations.
       - Compiled under PB4.10 for Vista compatibility. (Not tested)
