home *** CD-ROM | disk | FTP | other *** search
/ CD Actual 13 / CDA13.ISO / cdactual / demobin / share / program / Basic / BAS2QBAS.ZIP / BAS2QB.TXT < prev    next >
Encoding:
Text File  |  1988-01-15  |  5.1 KB  |  140 lines
  1.  
  2.      
  3.      
  4.      
  5.      
  6.      
  7.      
  8.      
  9.      
  10.      
  11.      
  12.      
  13.      
  14.                        BAS2QB - BASIC to QuickBASIC Converter
  15.      
  16.                                   (c)opyright 1988
  17.      
  18.                            International No-Bugs Software
  19.      
  20.                                 Program Information
  21.         
  22.      
  23.      
  24.                                     INTRODUCTION
  25.      
  26.      
  27.               BAS2QB  automates many of the source code  re-formatting 
  28.               procedures  commonly performed when switching over  from 
  29.               BASICA or GW-BASIC to Microsoft(t) QuickBASIC  (versions 
  30.               2 through 4).
  31.      
  32.      
  33.               BAS2QB programs become much more comprehensible,  and as 
  34.               a  result,  much  simpler  to  convert  into  structured 
  35.               formats.   This will allow you to take full advantage of 
  36.               QuickBASIC's talents as a spaghetti code reducer.
  37.      
  38.      
  39.               BAS2QB  uses a BASIC source code file (ASCII format)  as 
  40.               its  standard  input,  and  returns  a  newly  formatted 
  41.               program that includes:
  42.      
  43.                  1)     One statement per program line          
  44.                  2)     IF, THEN, ELSE Nested Indentation
  45.                  3)     END IF blocked structures
  46.                  4)     Removal of non-targeted line numbers
  47.                  5)     Replacement  of  targeted lines  with  either 
  48.                         program generated, or user-supplied labels
  49.      
  50.      
  51.      
  52.                                         NOTE
  53.      
  54.      
  55.               Don't expect to recognize your new programs immediately. 
  56.               BAS2QB  does  NOT alter variables or  actual  code,  but 
  57.               linear programs with meaningful line labels take time to 
  58.               adjust  to.   It is highly advisable to have a hard copy 
  59.               of  the  original (numbered) source code at  hand  while 
  60.               adding  mneumonic labels.  Each target line can then  be 
  61.               respresented  by  the function it  performs.   You  will 
  62.               probably  find  this approach is worth the  extra  time, 
  63.               since it must be performed only once.
  64.      
  65.         
  66.      
  67.      
  68.      
  69.                                     USING BAS2QB
  70.      
  71.      
  72.               BAS2QB  needs very little assistance in converting BASIC 
  73.               programs   to   QuickBASIC.   Listed   below   are   the 
  74.               only requirements:
  75.      
  76.                  1)  Program must be in ASCII format (save with ",A").
  77.                  2)  Program lines must NOT contain any line-feeds or
  78.                      other control characters.
  79.                  3)  Program lines must not exceed 255 characters.
  80.                  4)  Program source file must have a .BAS extension.
  81.      
  82.      
  83.               BAS2QB   does  NOT  alter  the  original  source   file.  
  84.               Instead, another file with the extension .QBX is created 
  85.               that will run under QuickBASIC versions 2 through 4.
  86.      
  87.      
  88.      
  89.      
  90.                                  OPERATIONAL NOTES
  91.      
  92.      
  93.               When  invoking  BAS2QB,  you  will  be  prompted  for  a 
  94.               filename.   Do  NOT include an extension - the only  one 
  95.               allowed is the default, .BAS.
  96.      
  97.               If  the  source file is located,  BAS2QB will  begin  to 
  98.               reformat  the  source  file  by  looking  at  each  line 
  99.               individually  and will present each target  line  number 
  100.               and a prompt for an optional label.
  101.      
  102.               When prompted, you may choose to:
  103.                  
  104.                  1)  Enter a line label (up to 20 Characters).
  105.      
  106.                  2)  Enter a RETURN. (BAS2QB will provide the label).
  107.      
  108.                  3)  Enter a period.  From that point forward,  BAS2QB 
  109.                      will provide target labels.
  110.      
  111.               The number listed on the LEFT side of the display is the 
  112.               source line number being examined.
  113.      
  114.               The  number (if any) on the RIGHT side of the display is 
  115.               the target line number that was found in a corresponding 
  116.               GOTO,  GOSUB,  THEN,  ELSE, etc.  Once a target has been 
  117.               labeled,  further  references  to  that target  will  be 
  118.               automatically replaced without user intervention.
  119.         
  120.      
  121.      
  122.      
  123.                                    ERROR TRAPPING
  124.      
  125.      
  126.               In  the case of ERL references,  BAS2QB will retain  the 
  127.               original  line number references in the newly  generated 
  128.               source  file.   This allows proper trapping through  the 
  129.               use of the IF ERL construct.
  130.      
  131.      
  132.                                     FINAL NOTE
  133.      
  134.               BAS2QB  performs no error checking.   Any BASIC  program 
  135.               that compiles correctly BEFORE conversion should compile 
  136.               correctly  AFTER  conversion.    BAS2QB  will  not   fix 
  137.               programs that do not run.
  138.  
  139.  
  140.