Script2Script (S2S) Introductory Readme.
Revision 1.0.22. Update 206. October 29, 2005.

Contents

  Installation
  Uninstallation
  Simple Usage
  Advanced Usage
  Components and Reliability
  Documentation and examples
  Freeware Restrictions
  License in plain English
  Contact
  License


Installation.

  If this is first S2S installation on given computer, 
  please follow steps 1 and 2.

     1. Run setup.exe
     2. Copy folder "Examples" to 'application folder',
        which will be chosen during installation.

  If you already have previous revisions of S2S on given computer and would
  like to install this revision additionally, then this can be done if
    
     a. install this revision to separate installation directory 
             (f.e. c:\Program Files\s2s21) when prompted,
     b. select different program group like Script2Script21
     c. dual revision setup was tested on Windows 95. They both coexisted
        smoothly and allowed separate uninstall of previous revision later.



To uninstall Script2Script:

     Control Panel\Add/Remove Programs may be used.
     The files and folders which have been created in 'application folder' manually,
     may be deleted manually after running Control Panel uninstallator.
     For example: folder Examples and file console.txt should be
     deleted manually.




Simple Usage

   S2S allows three-clicks-use:
   
   from S2S menu click:
       Project,
           select one of the converters from folder Examples like
           asp2php, vb2asp, or other project,
       Source,
           point to folder of file to be converted,
       Go.
   After conversion, take RESULT_FILES from folder common with source.
   'Quick-steps-sections' of particular converter can be consulted also.



Advanced Usage ...  
 
   ... is for users who want retune up particular converter, reset 
   converter settings, or write own converter using S2S as a framework.
   This user should consult Documentation and Examples.
   


S2s Software Package Components and Reliability

 S2s Software Package has two layers:

 Converters:                  vb2asp  asp2php  folder2html  db2text .... 
 GUI:          s2s.exe     -----------------------------------------------  
 Engine:                            Script2Script.dll

 The ground level, back-end, of all Converters is Script2Script.dll. 
 The upper level Converters are scripts, text files.  
 Additional module is s2s.exe, which is GUI to the Engine.

 As of this writing time, March 2004, 
 the current  Engine Revision 22 Update 76 is in use since   September 13, 2003, 
 and previous        Revision 22 Update 2b has been released July       4, 2003. 

 
 Both updates are heavily used, and no significant unfixed bugs in Engine are known.
 Thus, Engine reliability should be well established.
 In addition, the Engine is much simplier in sintax and code then
 upper level scripts, so there is less space for errors.
 
 Upper level Converters are used inside the company, 'in-house'.
 This Converters, GUI, and entire Package Documentation are not well-prepared for public release. 

 However, it seems not right to hide them in archive. 
 They are open source available for customizations.
 Converters are independent on each other.
 Thus, this is in hands of programmers to improve them or pick up their ideas.
  
 S2s.exe does not affect reliability of the package when menu\Go option is used. 
 When menu\Go option is used, 
   - the role of s2s.exe is merely to give to Script2Script.dll 
     the name of schema and source, and
   - then, Script2Script.dll reads from disk schema and source and processes them.
 

Independence on physical location and "self-sufficience" of converters

 Vb2asp, asp2php, and some other converters contained in separate folders.
 To run this converters, their folders can be moved to any place on disk.
 This converters are "self-contained".

 In the same manner, s2s.exe and Script2Script.dll can be (*) at any place on hard drive

 However, it is recommended to keep s2s-package structure as:

   Parent_Folder
        s2s.exe
        Script2Script.dll
        Examples
            Help
            vb2asp
            vb2asp_copy_pasted_modified_for_my_project
            asp2php
            ...
        Examples_copy_pasted_modified_for_another_my_projects
        ...

 This will preserve links between help files and readmes.
 The name of Parent_Folder has no importance (*).

 The taget folders or files to be converted can be at any place on the disk.
 User does not have to put source files under 'Parent_Folder' to make conversion.

 
 (*) It is assumed that Script2Script.dll registration in Windows Registry is kept correctly.






Documentation and Examples.

   Subfolder Help of folder Examples contains documentation for S2S.

   This documentation was not proofread as a whole and 
   may include drafts and unnoted discrepancies.

   Most tested Examples are:

      asp2php
      vb2asp
      folder2html
      list2preferences
      dBase2text

   Other examples may have more dicrepancies.
   There are no known bugs in Examples at time of this update.
   (Because it's just released:-) 

   More complete S2S Introduction.
   For documentation on particular converter, consult corresponding project
   like asp2php or vb2asp.


Script2Script.dll unregistered freeware version has following restrictions:

 file size limit 15000 bytes,
 subfolder deepness limit = 3,
 files number in project limit  = 3,
 nest deepness limit = 10,
 queue size limit = 15.

If one of this limits is met, 
Script2Script always explains why it does not like to continue. 
If program mailfunctions without clear explanation, 
then please report this bug to contact email.
As of today, S2S registration is free and can be done on-line.



License for Scripts:
Dec 04, 2002:
  -  Schemas and examples included with package and on "Development" site 
     are completely free for modifications and reuse in other projects 
     if you give a credit in your note that Pharmease original material has been used. 
  -  provided without warranty of any kind.  


License for "Script2Script Interface" Source Code (Script2Script.exe).
Jul 16, 2003:
  -  can be freely modified and/or reused in your work.
     It will be quite enough to give a credit in form of note:
        'Original code of "Script2Script Interface" by Konstantin Kirillov,
         Pharmease, Inc., has been partially used.'
     in appropriate place in source code and in executable. 
  -  is provided without warranty of any kind.  


License for Script2Script.dll
Jul 16, 2003:
  -  both registered and free versions 
     can be in corporate or personal use.
  -  can be freely distributed as an entire package;
     no files can be taken from the original 
     distribution package where Script2Script.dll belongs.
  -  program is provided without warranty of any kind.

Complete License for Script2Script.dll is written at the end of this readme.





Contact email: Script at Landkey.net

   Please report bugs or ask questions to this address although we
   cannot quarantee the response.


Thank you for using S2S.



THE END USER LICENSE AGREEMENT FOR Script2Script.dll IS PROVIDED BELOW

THIS VERSION OF Script2Script.dll IS NAMED HERE AS ''SOFTWARE''

IF SOFTWARE IS REGISTERED TO AN END USER, THEN IT IS NAMED HERE AS
''REGISTERED VERSION'' AND THIS USER IS NAMED HERE AS ''REGISTREE''.
IF SOFTWARE IS NOT REGISTERED, THEN IT IS CALLED FREEWARE VERSION.

REGISTREE CANNOT TRANSFER LICENCE AND REGISTRATION KEY TO
ANOTHER USER UNLESS REGISTREE COMPLETELY TRANSFERS 
REGISTERED VERSION TO ANOTHER USER AND NO LONGER USES
THIS REGISTERED VERSION.

THE FOLLOWING TEXT OF LICENSE APPLIES TO BOTH REGISTERED AND 
FREEWARE VERSIONS. ONLY PHARMEASE INC CAN SELL THIS SOFTWARE AND 
REGISTER IT TO AN END USER.

THIS SOFTWARE CANNOT BE DISASSEMBLED OR REVERSE ENGINEERED.

THIS SOFTWARE IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND.  
PHARMEASE INC. DISCLAIMS ALL WARRANTIES, EITHER
EXPRESS OR IMPLIED, INCLUDING THE WARRANTIES OF 
MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. 
IN NO EVENT SHALL PHARMEASE INC. OR ITS SUPPLIERS BE LIABLE FOR 
ANY DAMAGES WHATSOEVER INCLUDING DIRECT, INDERECT, INCIDENTAL, 
CONSEQUENTIAL, LOSS OF BUSINESS PROFITS OR SPECIAL DAMAGES, EVEN
IF PHARMEASE INC. OR ITS SUPPLIERS HAVE BEEN ADVISED OF THE 
POSSIBILITY OF SUCH DAMAGES. CLIENT AGREES TO HOLD PHARMEASE INC. 
HARMLESS FROM AND AGAINST ANY AND ALL CLAIMS, LOSSES, 
LIABILITIES AND EXPENSES.

THIS SOFTWARE CAN BE IN PERSONAL OR COMMERSIAL USE. 

THIS SOFTWARE IS FREELY DISTRIBUTABLE. NONE OF FILES, COMPONENTS, 
AND COPYRIGHT NOTICES CAN BE REMOVED FROM ORIGINAL DISTRIBUTION
PACKAGE.