home *** CD-ROM | disk | FTP | other *** search
/ Liren Large Software Subsidy 10 / 10.iso / l / l351 / 1.ddi / README.LIT < prev   
Encoding:
Text File  |  1993-02-03  |  7.7 KB  |  174 lines
  1.  
  2.     Installation Instructions for 286|DOS-Extender Lite (TM)
  3.  
  4. Technical Support             Email: tech-support@pharlap.com
  5. Phar Lap Software, Inc.         BBS: +1 617 661 1009 (300-9600, 8N1)
  6. 60 Aberdeen Ave.              Voice: +1 617 661 1510
  7. Cambridge, MA  02138            FAX: +1 617 876 2972
  8.  
  9. Welcome, and thank you for using Phar Lap's 286|DOS-Extender Lite 3.0.
  10. Lite is a special trial version of Phar Lap's award-winning
  11. 286|DOS-Extender SDK designed for users of Microsoft's Visual C++ 1.0.  If
  12. you enjoy using 286|DOS-Extender Lite, we hope that you will consider
  13. purchasing our full-featured SDK.
  14.  
  15. These notes explain how to install Lite on your hard disk, provide a
  16. simple description of building one of the example programs, and describe
  17. other documentation files on this diskette.  A complete description of how
  18. to compile for protected mode can be found in LITE286.DOC, described
  19. below.
  20.  
  21. 286|DOS-Extender Lite is a product of Phar Lap Software, Inc.  If you
  22. you require assistance during installation, please contact Phar Lap
  23. Software Technical Support.  Please do not contact Microsoft Corporation
  24. with questions about this product.
  25.  
  26. *******************************************************************************
  27.             Other Documentation
  28. *******************************************************************************
  29.  
  30. There are several other files which contain valuable information about
  31. 286|DOS-Extender Lite.  These files are copied to a subdirectory called
  32. \DOC during installation.
  33.  
  34. LITE286.DOC contains the "Visual C++ 286|DOS-Extender Lite User's Guide."
  35. It explains how to compile and run DOS-extended programs after installing
  36. Lite.  You may want to print this file and keep it handy as a reference
  37. while you are writing programs for Lite.
  38.  
  39. LITEINFO is a short description of 286|DOS-Extender Lite, and contains an
  40. overview of the major differences between Lite and our full-featured SDK.
  41. It is identical to the text that is displayed if you run LITE286.EXE with
  42. no arguments or options.
  43.  
  44. INTL.DLR contains a list of overseas dealers.  If you are outside the USA,
  45. please feel free to contact either Phar Lap or one of these dealers for
  46. technical support, or to order your 286|DOS-Extender SDK.
  47.  
  48. ORDER.FRM provides a convenient way to purchase 286|DOS-Extender SDK.
  49.  
  50.  
  51. *******************************************************************************
  52.             Installation
  53. *******************************************************************************
  54.  
  55. Before installing 286|DOS-Extender Lite, you must have previously
  56. installed Microsoft Visual C++ Professional Edition 1.0 on your hard
  57. drive.  You must have installed real-mode libraries to use Lite, that is,
  58. you must have selected (at least) "MS-DOS .EXE Files" from the "Targets"
  59. menu in the "Library Options" dialog box when you installed Visual C++.
  60. Lite programs may be compiled either in the Visual Workbench, or from the
  61. DOS command line.  All of our examples are compiled from the DOS command
  62. line.
  63.  
  64. For our examples, we assume you have installed Visual C++ in C:\MSVC.  If
  65. you have installed it elsewhere, modify these instructions accordingly.
  66.  
  67. Installing 286|DOS-Extender Lite is a two-step process.  First, you must
  68. copy all of the files from the distribution diskette to your hard drive.
  69. Second, you must build a special, protected-mode version of the C run-time
  70. library.  After you have completed both of these steps, you are ready to
  71. start building protected mode applications!
  72.  
  73.  
  74. Step 1: Copy Files From Diskette
  75. --------------------------------
  76.  
  77. To copy the files from the diskette, insert the distribution diskette
  78. and type "A:INSTALL".  The installation program will then ask you a
  79. series of questions.  You may either install Lite in the suggested
  80. directory or specify your own location.  These instructions assume that
  81. you install Lite in C:\LITE286.  If you have 286|DOS-Extender SDK, you
  82. should *not* install Lite in the same directory as the SDK.
  83.  
  84. If you prefer not to use our interactive installation program
  85. A:INSTALL.EXE, you may copy the files with xcopy:
  86.  
  87.     C:\> xcopy a:\ c:\lite286\. /s
  88.  
  89.  
  90. Step 2: Build a Visual C++ Run-Time Library
  91. -----------------------------------------
  92.  
  93. Instead of using the large-model real-mode LLIBCE.LIB that comes with
  94. Visual C++, 286|DOS-Extender Lite requires a protected-mode library called
  95. LLIBCEP.LIB.  LLIBCEP.LIB is based on LLIBCE.LIB but contains some small
  96. but important modifications for protected mode.  The batch program
  97. \LITE286\MSVC\LIB\MKLIB.BAT creates LLIBCEP.LIB from a copy of
  98. LLIBCE.LIB.  The new library is created in \LITE286\MSVC\LIB.  MKLIB.BAT
  99. does not in any way modify files in the \MSVC directory tree.
  100.  
  101. MKLIB.BAT should be executed while \LITE286\MSVC\LIB is the current
  102. directory:
  103.  
  104.     C:\> cd \lite286\msvc\lib
  105.     C:\LITE286\MSVC\LIB> mklib l e \msvc\lib
  106.  
  107. MKLIB.BAT invokes LIB.EXE from Microsoft Visual C++ 1.0 -- if MKLIB.BAT
  108. fails, check that you installed Visual C++ correctly, and that \MSVC\BIN
  109. is in your PATH environment variable.
  110.  
  111.  
  112. *******************************************************************************
  113.             Building Sample Executables
  114. *******************************************************************************
  115.  
  116. The Microsoft Visual C++ compiler, CL.EXE, is capable of creating
  117. protected-mode executables using the (nearly undocumented) "-Lp" switch,
  118. and the "STUB" directive of a .DEF file.  An example of creating a
  119. protected-mode program is presented here.
  120.  
  121. LITE286.DOC provides complete details of the build process; it also
  122. describes LITE286.EXE and GORUN286.EXE, the programs which actually load
  123. and execute your program in protected mode.
  124.  
  125.  
  126. Microsoft Visual C++ -- Compiling with CL
  127. -----------------------------------------
  128.  
  129. CL.EXE uses certain environment variables to control its operations.
  130. These variables are not strictly required, but we will use them in this
  131. demonstration.  For complete information about LIB and INCLUDE, please
  132. consult the Microsoft documentation.
  133.  
  134. The LIB environment variable contains a list of directories in which to
  135. search for libraries.  This list must include Lite's library directory in
  136. addition to Visual C++'s.
  137.  
  138. The PATH environment variable must include both Lite's executable
  139. directory and Visual C++'s.
  140.  
  141.     C:\LITE286\EXAMPLES> set LIB=\lite286\msvc\lib;\msvc\lib
  142.     C:\LITE286\EXAMPLES> set PATH=\dos;\msvc\bin;\lite286\bin
  143.     C:\LITE286\EXAMPLES> set INCLUDE=\msvc\include;\lite286\inc
  144.  
  145.     C:\LITE286\EXAMPLES> cl -AL -Lp hello.c
  146.     C:\LITE286\EXAMPLES> bind286 hello.exe
  147.     C:\LITE286\EXAMPLES> hello
  148.     Hello from protected mode!
  149.  
  150.     C:\LITE286\EXAMPLES> cl -AL -Lp hello.c \lite286\msvc\lib\example.def
  151.     C:\LITE286\EXAMPLES> hello.exe
  152.     Hello from protected mode!
  153.  
  154. In the first example, the "stub loader", that is, the real-mode code
  155. required to load 286|DOS-Extender Lite, is attached to hello.exe by the
  156. program BIND286.EXE.  In the second example, EXAMPLE.DEF directs the
  157. Microsoft linker (LINK.EXE) to include the stub loader.  More information
  158. about the default stub loader, GORUN286.EXE, is in LITE286.DOC.
  159.  
  160.  
  161.  
  162. *******************************************************************************
  163.                 What Next?
  164. *******************************************************************************
  165.  
  166. You have now completely installed 286|DOS-Extender Lite, and are ready to
  167. build multimegabyte programs.  Please read the file LITE286.DOC for more
  168. information on protected-mode programming.
  169.  
  170. We sincerely hope that you find 286|DOS-Extender Lite both useful and easy
  171. to use.  If Lite makes you more productive, then consider what our
  172. full-featured 286|DOS-Extender SDK can do for you!  Ordering information
  173. is contained in the files LITEINFO, ORDER.FRM, and INTL.DLR.
  174.