HELP FILE

 - this file is a mirror of the schema file main.htm,
 - this mirror is not used in converter, but
 - provides help notes for using main.htm,
 - this notes are referenced from main.htm

Schema start up files should have names which easy to recognize.
The word "main" should indicate such files.

Enabling Schema in HTML

Be aware that using characters > < & is not safe
when this page is viewed as HTML, but safe for all other purposes.
Thus, to continue to write scheams as HTML pages, obvious care should
be taken to not confuse Web-browser. 

Another formally non-safe character is double-quouters ", but 
good browser should always understand this in text.


S2S project start point

\\  

'

'PROJECT SWITCHES

   ' 

   'Some of this startup variables are ASP-resettable,
   'and some of them AQP-handled.

   'don't forget to disable this debug settings:

                             ' 
   |=scenario." ""P""        ' this is an example how to 
                             ' set both variable and a comment in asp: 
                             ' this text will appear in asp;
                             ' double-double quotas are significant for schema here:
                             ' ""D""-dynamic:   invoke dll at first call;
                             ' ""P""-preparsed: design-time-values have precendence;
   "                         'AQP-handled

                             ' 
   |=trace_application."T"   ''AQP-handled
                             ' activate "trace web-application" mode, to
                             ' enable output from web-dll to console and to file
                             ' when inserting calls 
                             '      web_c.t s  
                             ' into web-dll source code;
                             ' "T" enables; other value is ignored;
                             ' Query and Post handled.

                             ' 
   |=Server_ScriptTimeOut."180"    'seconds, sets script time out for asp
                                   'ASP-resettable
                                   'by default, it is too big: 3 minutes:
                                   'to allow slow debug in VB IDE;
                                   'should be decreased for release version;

   '
   |=AllowLocal.""           'AQP-handled
                             '"L", local, allows forms to appear on Server
                             'side as it was in original application.
                             'In this case, user on server 
                             'may be able to work with application as
                             'it was before, except that changes are not
                             'reflected on Web without refresh from Browser.

   ' 
'
   ' 
   ' FIRST ROUND SWITCH

   |=copy_all.""             
                             ' If set to "T", then at first round
                             '    an entire content of source folder
                             '    (copying all subdirectories' structure)
                             '    will be copied to RESULT_FILES.
                             '    (creating subfolders if necessary.)
                             ' Any value other than "T" does not copy files.
                             ' See/add also: "ultimate exentions to move"
                             '    in section "FIRST ROUND JOB"
                             '    which supersedes "copy_all".
                             ' Because this switch works on first round, its job
                             ' is independend on second round switches, but may be
                             ' overwritten by second round switches.
                             ' This switch may be usefull if programmer would like
                             ' to copy files not linked to *.vbp file, but 
                             ' conveniently stored in project subfolders.
   ' 
'
   ' 
   ' SECOND ROUND SWITCHES
   ' To test full conversion functionality, assign "T" to all this switches.

  
   '  
   '  Specifies myproject.vbp, project to be converted.
   '  If variable "project_to_convert" is empty or
   '  commented out, then
   '     the first met *.vbp file will be taken as myproject.vbp and converted,
   '     and other *.vbp ignored:
   '  (the final variable which holds myproject name is $project_file_basic)
   
   |=project_to_convert."malone_630.vbp" 

  
   
   '================================================================================
   ' Selection Switches.
   '
   ' This five switches override settings in corresponding "convert... files".
   ' For example, "Convert_all_forms."T" will trigger to convert all forms
   '     disregarding forms preset in file convert_this_forms.txt.
   '
   ' Setting any of this switches to "T" enables the switch.
   ' Setting to other value has no effect.
   '--------------------------------------------------------------------------------
   |=Convert_all_forms.""   
   |=Convert_all_modules.""
   |=Convert_all_classes.""
   |=Variable_geometry.""    'T - enables dynamic geometry.
   |=Variable_visibility.""  'T - enables dynamic visibility.
   '================================================================================
   

   ' 
   ' 'Copy entire project' switch   

   |=copy_entire_project."T" ' This switch works for itmes: forms, classes, modules.
                             ' This switch copies files without converting them
                             '      creating subfolders if necessary.
                             ' This is "the last resort" switch or
                             ' "weakest" switch.
                             ' This switch works only 
                             '    if set to "T", and 
                             '    if "convert" option 
                             '       is NOT set for item 
                             '         by Convert_all_... switch AND
                             '       is NOT set for item 
                             '         by convert_this_....txt file.
                             ' (If all files where copied in first round this switch
                             ' makes no difference.)

   '
'
|=hide_graphics."T" ' "T" means that picture box, images, clips ' placeholders will be inserted in web pages, but with ' visibility:hidden; property. ' However, they can be easily found in ' asp-pages and modified. ' |=ConvertShow."F" ' vb2asp has no knowledge what type of property ' "Show" has Object.Show ' This can be normal visibility property for form ' or some user defined property of user object. ' In addition to this, forms may have ' visibility "True" on Web, but not visible on server. ' ' To optimistically convert method .Show, choose "T". ' All converted statements will be displayed on ' s2s console and commented in result. ' At the beginning of line, simple forms of ' Object.Show [modalness] ' Object.Show 'comment ' are converted to ' web_SetVis Object, -1 ' More complex (like .show, or .show ' in the middle of line ) must be converted manually. ' Converter marks converted .show statements. ' Vb Versions: |=SourceVBVersion."" 'Options: 6, "". "" - atorecognition |=ResultVBVersion."" 'Options: 6, "". "" - avoid to rase version from 4 to 6, ' "" - considered 'safer'; ' 6 - force output to 6; 'Perhaps, MS VB allows different files of 'project to have different version. ' ' Dll call timeouts ' ASP-resettable ' ' Some application have startup/shutdown timers, f.e. for splash screens: ' To give timers timeslice to finish, ' this parameters and manual work may be needed: ' Setting them to 0 disables them: ' |=delay_at_first_visit."""0"" 'in seconds, actually works for run-time also " |=shutdown_delay."""0"" 'in seconds " |include."Subschemas\\main_aux.txt" |end AQP-handled means that shema variable is ASP-resettable, (A), and, in addition, can be controlled from the browser by Query String(Q), and pesist in web pages via hidden form's value (P). ASP-resettable ... .. is a schema variable which sets corresponding variable in ASP code. After conversion, ASP variable can still be modified.