home *** CD-ROM | disk | FTP | other *** search
/ Media Share 9 / MEDIASHARE_09.ISO / progmisc / bldr10b.zip / README.1ST < prev    next >
Text File  |  1993-04-14  |  7KB  |  174 lines
  1. Builder 1.0 Late Breaking News and Installation Instructions.
  2.  
  3. First the News...
  4.  
  5. o  If you get the error 'CONFIG.SYS FILES too low set to a minimum of 21',
  6.    edit or add the FILES= line in your CONFIG.SYS file and set to a number
  7.    greater than or equal to 21 (FILES=21).  If you need to make this change
  8.    be sure to reboot before executing BUILDER again.  See your DOS manual for
  9.    further information on the FILES= CONFIG.SYS command.
  10.  
  11. o  If you get the error 'CLIPPER Environment F Parm too Low Set to a
  12.    Minimum of F21', enter the dos command:
  13.  
  14.        SET CLIPPER=F21
  15.  
  16.    at the DOS command line before entering Builder.  Put this command in
  17.    your AUTOEXEC.BAT file if you continue to use BUILDER.
  18.  
  19. o  In BUILDER when moving window elements the control down arrow and control
  20.    up arrow on some computers doesn't work.  I added control page down and
  21.    control page up which may be used if control up/down arrows do not.
  22.  
  23. o  In BUILDER small comment windows have been added before entering window
  24.    data (20 characters), these are used in building a procedure map at the
  25.    beginning of the generated source code file and is VERY useful in keeping
  26.    track of the code.  It is strongly reccomended that you use them.
  27.  
  28. ********* CHANGES TO LIBRARY ROUTINES **********
  29.  
  30. o  REL_MAINT - This is documented in LIBRARY.DOC as a procedure, and is
  31.    now a function.  The first four parameters are incorrectly documented.
  32.    They should be four numerics of the box coordinates.  Parm one is the
  33.    box top row, parm two is the box left column position, parm three is the
  34.    bottom box row, and parm four is the rightmost column position.
  35.  
  36.    Also for REL_MAINT, the GET??? proc you create will be passed one
  37.    parameter.  This parameter will be a "A", "C" or "" (nul).  "A" is passed
  38.    if the GET??? proc is being executed just prior to an ADD.  "C" is passed
  39.    if the GET??? proc is being executed just prior to a CHANGE.  Nul is passed
  40.    when the GETs will be followed by a CLEAR GETS.
  41.  
  42. =============================================================================
  43. Now the Installation Instructions.
  44. =============================================================================
  45.  
  46. Since this system is geared toward programmers I have chosen not to include
  47. a fancy installation routine.  Even so installation is quite simple.  It
  48. includes five simple steps:
  49.   1.  Be sure you have all the files.
  50.   2a. Rename the library you will be using for your version of Clipper.
  51.   2b. Copy the three BUILDER files to the appropriate subdirectories.
  52.   2c. Modify the batch file you will be using in your compiles.
  53.   3.  Print the documentation.
  54.  
  55. Now lets get to it...
  56.  
  57. Step 1.
  58.   Be sure you downloaded or obtained both .ZIP files!  BLDR10A.ZIP and
  59.   BLDR10B.ZIP.  If either one is missing the system will not work.
  60.  
  61.   Once you have both files.  Unzip them into a temporary work subdirectory and
  62.   verify all the files against the list in the file PACKING.LST.  If any
  63.   file(s) are missing the system may be unusable!
  64.  
  65.   Step 1 completed!
  66.  
  67. Step 2.
  68.   A. Decide which version of Clipper you will be using, Summer '87 or Version
  69.      5.x.
  70.  
  71.      If you will be using the Summer '87 version, execute the following DOS
  72.      command:
  73.  
  74.         RENAME BUILDER.S87 BUILDER.LIB
  75.  
  76.      If you will be using Version 5.x of Clipper, execute this command:
  77.  
  78.         RENAME BUILDER.C50 BUILDER.LIB
  79.  
  80.      Step 2a completed!
  81.  
  82.   B. Copy the BUILDER files to their appropriate subdirectories.
  83.  
  84.      Summer '87 users:
  85.        Make sure you have your DOS Path set to the subdirectory where the
  86.        CLIPPER.EXE (compiler executable) file is located. (usually C:\CLIPPER)
  87.  
  88.        Copy the following files to the subdirectory where the file CLIPPER.EXE
  89.        is located:
  90.  
  91.          BUILDER.EXE
  92.          BREPORT.EXE
  93.  
  94.        Copy the file BUILDER.LIB to the subdirectory where the file CLIPPER.LIB
  95.        is found, again this is usually C:\CLIPPER
  96.  
  97.      Version 5.x users:
  98.        Make sure you have your DOS Path set to the subdirectory where the
  99.        CLIPPER.EXE (compiler executable) file is located.
  100.        (usually C:\CLIPPER5\BIN)
  101.  
  102.        Copy the following file to the subdirectory where the file CLIPPER.EXE
  103.        is located:
  104.  
  105.          BUILDER.EXE
  106.          BREPORT.EXE
  107.  
  108.        Copy the file BUILDER.LIB to the subdirectory where the file CLIPPER.LIB
  109.        is found, usually C:\CLIPPER5\LIB
  110.  
  111.      Step 2b completed!
  112.  
  113.   C. If you use .LNK files, be sure to include BUILDER in your library search!
  114.      Since a different .LNK is used for every program I will assume you already
  115.      know how to add this for your particular linker.
  116.  
  117.      If you use the DOS command line when executing your linker modify your
  118.      batch file to search the BUILDER library.  Use the following examples as
  119.      a guide:
  120.  
  121.      PLINk86 users:
  122.  
  123.        plink86 fi %1 lib clipper,builder,extend
  124.  
  125.        note:  The ORDER is IMPORTANT!!  BUILDER must precede EXTEND !!
  126.               Your best bet is to put BUILDER right after CLIPPER in the
  127.               library listing.
  128.  
  129.      RTLINK users:
  130.  
  131.        Change the following line in the CL.BAT file:
  132.  
  133.          if not errorlevel 1 rtlink file %1
  134.  
  135.        to look like the this:
  136.  
  137.          if not errorlevel 1 rtlink file %1 lib builder
  138.  
  139.     Step 2c completed!
  140.  
  141. 3. Print the documentation.
  142.     You may skip this step if you are just starting your evaluation, no sense
  143.     wasting all that paper/time/ink/toner on a product you haven't decided to
  144.     use, right?  If so remember that BUILDER creates a number of files for
  145.     itself.  The best approach (and the one I use) is to create a separate
  146.     subdirectory for each application you will write.  Select the empty
  147.     subdirectory and type BUILDER at the DOS prompt to get started.
  148.  
  149.     If you do accidentally invoke BUILDER in a subdirectory and want to rid
  150.     it of BUILDERs files, use the following DOS commands to get rid of them.
  151.  
  152.       DEL *.BL?
  153.       DEL OPTIONS.DBF
  154.  
  155.     But then maybe you've decided BUILDER will make your programming a whole
  156.     lot easier and have found you really NEED a copy of the library
  157.     documentation.  Well you might as well print the other stuff too, never
  158.     know what interesting tidbits lurk in there!  Be sure the DOS PRINT command
  159.     is in your DOS PATH and type the DOS command "PDOC" to print all the
  160.     BUILDER documentation.
  161.  
  162.     If you lost PDOC.BAT the print order I like is:
  163.  
  164.       PRINT WARRANTY.DOC
  165.       PRINT LICENSE.DOC
  166.       PRINT BUILDER.DOC
  167.       PRINT BREPORT.DOC
  168.       PRINT LIBRARY.DOC
  169.  
  170.   Step 3 completed!
  171.  
  172. Good Luck and happy BUILDERing if you have difficulty, even if you are not a
  173. registered user please feel free to call Mark @ (612) 699-8672
  174.