home *** CD-ROM | disk | FTP | other *** search
/ Liren Large Software Subsidy 10 / 10.iso / l / l352 / 1.img / README.1ST < prev   
Encoding:
Text File  |  1992-06-04  |  7.4 KB  |  158 lines
  1.     Installation Instructions for 286|DOS-Extender Lite (TM)
  2.  
  3. Phar Lap Software, Inc.
  4. 60 Aberdeen Ave.        Voice: +1 617 661 1510
  5. Cambridge, MA  02138        FAX: +1 617 876 2972
  6.  
  7. Welcome, and thank you for using Phar Lap's 286|DOS-Extender Lite.
  8. Lite is a special, limited version of Phar Lap's award-winning
  9. 286|DOS-Extender SDK designed exclusively for users of Borland C++
  10. 3.1.  If you enjoy using 286|DOS-Extender Lite, we hope that you will
  11. consider purchasing our full-featured SDK.
  12.  
  13. These notes explain how to install Lite on your hard disk, provide a
  14. simple description of building one of the example programs, and describe
  15. other documentation files on this diskette.  A complete description of how
  16. to compile for protected mode can be found in LITE286.DOC, described below.  
  17.  
  18. *******************************************************************************
  19.             Other Documentation
  20. *******************************************************************************
  21. There are several other files which contain valuable information about
  22. 286|DOS-Extender Lite.  These files are located in the distribution
  23. diskette in a directory called A:\DOC, and are copied to \LITE286\DOC
  24. during installation.
  25.  
  26. LITE286.DOC contains "Borland C++ User's Guide to 286|DOS-Extender Lite".
  27. It explains how to compile and run DOS-extended programs after installing
  28. Lite.  You may want to print this file and keep it handy as a reference
  29. while you are writing programs for Lite.
  30.  
  31. LITEINFO is a short description of 286|DOS-Extender Lite, and contains
  32. an overview of the major differences between Lite and our full-featured
  33. SDK.  It is identical to the text that is displayed if you run
  34. LITE286.EXE with no arguments or options.
  35.  
  36. INTL.DLR contains a list of overseas dealers.  If you are outside the
  37. USA, please feel free to contact either Phar Lap or one of these dealers
  38. for technical support or to order your 286|DOS-Extender SDK.
  39.  
  40. ORDER.FRM is a copy of the coupon included in the 286|DOS-Extender
  41. Lite package.
  42.  
  43. *******************************************************************************
  44.             Installation
  45. *******************************************************************************
  46. Before installing 286|DOS-Extender Lite, you must have previously installed
  47. Borland C++ 3.1 on your hard drive.  Please note that to use Lite, you need
  48. not install the entire 3.1 release; only the command-line compiler and the
  49. DOS large-model libraries are required.  If you wish to write protected-mode
  50. graphics programs using the Borland Graphics Interface (BGI), then you must
  51. also install that component.  Lite does not require, and will not use, any of
  52. the files installed by the "Windows Options..." menu.
  53.  
  54. For our examples, we assume you have installed Borland C++ in C:\BORLANDC.
  55. If you have installed it elsewhere, modify these instructions accordingly.
  56.  
  57. Installing 286|DOS-Extender Lite is a three-step process.  First, you
  58. must copy all of the files from the distribution diskette to your hard
  59. drive.  Second, you must build a special, protected-mode version of the
  60. C run-time library.  Third, you may optionally build a special version
  61. of the graphics library.  After you have completed each of these steps,
  62. you are ready to start building protected mode applications!
  63.  
  64.  
  65. Step 1: Copy Files From Diskette
  66. --------------------------------
  67. To copy the files from the diskette, insert the distribution diskette
  68. and type "A:INSTALL".  The installation program will then ask you a
  69. series of questions.  You may either install Lite in the suggested
  70. directory or specify your own location.  These instructions assume that
  71. you install Lite in C:\LITE286.  If you have 286|DOS-Extender SDK, you
  72. should *not* install Lite in the same directory as the SDK.
  73.  
  74. If you prefer not to use our interactive installation program
  75. A:INSTALL.EXE, you may copy the files with xcopy:
  76.  
  77.     C:\> xcopy a:\ c:\lite286\. /s
  78.  
  79.  
  80. Step 2: Build a Run-Time Library
  81. --------------------------------
  82. Instead of using the large-model real-mode CL.LIB that comes with
  83. Borland C++, 286|DOS-Extender Lite requires a protected-mode library
  84. called BCL286.LIB.  BCL286.LIB is based on CL.LIB but contains some
  85. small but important modifications for protected mode.  The batch
  86. program \LITE286\BC3\LIB\MKLIB.BAT creates BCL286.LIB from a copy of
  87. CL.LIB.  The new library is created in \LITE286\BC3\LIB.  MKLIB.BAT
  88. does not in any way modify files in the \BORLANDC directory tree.
  89.  
  90. MKLIB.BAT should be executed while \LITE286\BC3\LIB is the current directory:
  91.  
  92.     C:\> cd \lite286\bc3\lib
  93.     C:\LITE286\BC3\LIB> mklib l \borlandc\lib
  94.  
  95. MKLIB.BAT invokes LIB.EXE from Borland C++ 3.1 -- if MKLIB.BAT fails,
  96. check that you installed Borland C++ correctly, and that \BORLANDC\BIN
  97. is in your PATH environment variable.
  98.  
  99. Step 3: Build a Graphics Library
  100. --------------------------------
  101. Protected-Mode Lite programs can call the Borland Graphics
  102. Interface (BGI).  Just as a special version of the C library
  103. must be built, you must build a special version of the graphics
  104. library.
  105.  
  106. The batch program which does this is \LITE286\BC3\LIB\MKGRAPH.BAT:
  107.  
  108.     C:\LITE286\BC3\LIB> mkgraph \borlandc\lib
  109.  
  110.  
  111. *******************************************************************************
  112.             Building Sample Executables
  113. *******************************************************************************
  114. To simplify building protected-mode executables, we provide
  115. \LITE286\BIN\BCC286.EXE.  BCC286 acts as a "front-end" to BCC.EXE and
  116. TLINK.EXE, providing them with all the proper options and arguments.  For
  117. complete documentation on BCC286.EXE, consult the file LITE286.DOC.
  118.  
  119. BCC286.EXE uses certain environment variables to control its operations.
  120. These variables are not strictly required, but we will use them in this
  121. demonstration.
  122.  
  123. The LIB environment variable contains a list of directories in which to
  124. search for libraries and startup object modules.  This list must include
  125. Lite's library directory in addition to Borland C++'s.
  126.  
  127. The PATH environment variable must include both Lite's executable directory
  128. and Borland C++'s.
  129.  
  130.     C:\LITE286\EXAMPLES> set LIB=\lite286\bc3\lib;\borlandc\lib
  131.     C:\LITE286\EXAMPLES> set PATH=\dos;\lite286\bin;\borlandc\bin
  132.     C:\LITE286\EXAMPLES> bcc286 hello.c
  133.     C:\LITE286\EXAMPLES> hello.exe
  134.     Hello from protected mode!
  135.  
  136. When compiling a program that uses BGI for real mode you link against
  137. GRAPHICS.LIB.  For protected mode, the library to use is GRAPH286.LIB.
  138. Assuming the environment variables are still set as above, then building
  139. a protected-mode BGIDEMO.EXE is as simple as:
  140.  
  141.     C:\LITE286\EXAMPLES> bcc286 bgidemo.c graph286.lib
  142.  
  143. LITE286.DOC provides complete details of the build process; it also
  144. describes LITE286.EXE and GORUN286.EXE, the programs which actually
  145. load and execute your program in protected mode.
  146.  
  147. *******************************************************************************
  148.                 What Next?
  149. *******************************************************************************
  150. You have now completely installed 286|DOS-Extender Lite, and are ready to
  151. build multi-megabyte programs.  Please read the file LITE286.DOC for more
  152. information on protected-mode programming.
  153.  
  154. We sincerely hope that you find 286|DOS-Extender Lite both useful and
  155. easy to use.  If Lite makes you more productive, then consider what our
  156. full-featured 286|DOS-Extender SDK can do for you!  Ordering information
  157. is contained in the files LITEINFO, ORDER.FRM, and INTL.DLR.
  158.