Script2Script (S2S) Introductory Readme.
Revision 1.0.1135. March 14, 2008.

Script2ScriptG is a scriptable state machine released under this freeware license.
This program is designed to parse and convert scripts.

Copyright (c) 2008 Konstantin Kirillov.


Contents

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


Installation.

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

     1. Run setup.exe
     2. Run s2s and complete installation prompts.

  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,
     can be deleted manually after running Control Panel uninstaller.
     For example: folder Examples and file console.txt should be
     deleted manually.




Simple Usage

   S2S allows three-clicks-use from prebuilt projects:
   
   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.
   Results will be in RESULT_FILES folder next to source.
   'Quick-steps-sections' of particular converter can be consulted also.



Advanced Usage ...  
 
   ... is for users who want to 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 March 2004, 
 Engine Revision 1.0.22.76 is in use since   September 13, 2003, and
 previous        1.0.22.2b has been released July       4, 2003. 

 
 Both updates were 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-edited for public release. 
 Upper level Converters are independent on each other.
 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.

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





Contact email: BeaverScript/at/Landkey.net
   /at/ stands for @
   Please report bugs or ask questions to this address.
   We try our best to repspond.


Thank you for using S2S.