What vb2asp converter does

   Terminology:
       VB-Project includes myproject.vbp file, form files, module files, and class files.       
       Form file has two parts: 
          - top part is control-script - describes controls and their initial properties,
          - second part vb-code - 'basic language' code which is a set of subroutines and methods.

   Converter does:
       - parses control-script and generates the asp and JS code to represent this controls. 
       - does not parse all of vb-code, but merely passes the bulk of it to the Dll.
        (There is no need to make thorough parsing because source and result code written
        in the same platform.)

       - does not move event handlers from VB to JS. 
         Handlers of VBP-Source remain in Dll.
       - controllably adds vbw-code to Dll:
           - code to manage visibility (hide on Server and display on Browser)
           - code to manage z-order
           - debugger
     
         'Controllably' means that programmer can choose to wich forms add 
         visibility vbw-code and to which not using converter switches.
 


What Controls are converted

  'Dynamic' below means 'controlled by dll on Server side.'
  Dynamic/Fixed setting is optional before conversion.

  Dynamic visibility with JavaScript-enabled control's navigation:

     VB Menu 
     SSTab   

  Dynamic visibility and geometry:

     Command Button,
     Text box,
     OptionButton,
     CheckBox,
     Label,
     ListBox,
     ComboBox (reduced to ListBox),
     Image (partially; picture must be linked manually;),
     Frame.


  Information input processed by dll from controls:
     TextBox,
     OptionButton,
     CheckBox.

  Only simpliest form:

     MsgBox [name | string]

  is converted (in forms and modules) and its modal behaviour
  REPLACED with modeless.
  Restore modal behaviour manually if needed.

  Other controls are remained in dll and their
  placeholders are inserted into Web page with visibility:hidden.
  
  To convert more controls they can be
  added to schema in file 
  ASSEMBLE_CONTROLS.txt.
  This file contains examples how to
     add ListBox, TextBox,
     how to completely exclude control 
     from web page, or
     make an invisible
     placeholder on the web page.
  In simple cases, this file is only the
  place in schema to add the code to convert the control.


What Events are converted


  Only VB Menu and Command Button calls
  are detected and responded by dll.
  For example, 'On change' events are not converted and ignored on Browser.