{ "disks": { "1": { "dirs": [ { "path": "/", "files": [ { "name": "README 1ST", "size": 7552, "date": "1992-06-04", "time": "17:04" }, { "name": "READ INS", "size": 1040, "date": "1991-01-23", "time": "18:00" }, { "name": "DISK ID", "size": 58, "date": "1992-06-04", "time": "17:05" }, { "name": "INSTALL DAT", "size": 6674, "date": "1992-06-04", "time": "17:04" }, { "name": "INSTALL EXE", "size": 111255, "date": "1991-02-06", "time": "17:10" }, { "name": "BIN", "dir": true, "date": "1992-10-01", "time": "18:37" }, { "name": "BC3", "dir": true, "date": "1992-10-01", "time": "18:38" }, { "name": "INC", "dir": true, "date": "1992-10-01", "time": "18:39" }, { "name": "EXAMPLES", "dir": true, "date": "1992-10-01", "time": "18:39" }, { "name": "DOC", "dir": true, "date": "1992-10-01", "time": "18:40" } ] }, { "path": "/BIN", "files": [ { "name": "CFIG286 EXE", "size": 47216, "date": "1991-05-28", "time": "17:37" }, { "name": "DOSCALLS DLL", "size": 9861, "date": "1991-11-27", "time": "17:15" }, { "name": "GORUN286 EXE", "size": 13531, "date": "1991-11-26", "time": "11:19" }, { "name": "INT33 DLL", "size": 2649, "date": "1991-11-26", "time": "10:28" }, { "name": "KBDCALLS DLL", "size": 3107, "date": "1991-11-26", "time": "10:28" }, { "name": "LITE286 EXE", "size": 210972, "date": "1992-06-04", "time": "17:22" }, { "name": "MOUCALLS DLL", "size": 6264, "date": "1991-12-11", "time": "16:56" }, { "name": "PHARLAP 386", "size": 9342, "date": "1991-11-27", "time": "13:22" }, { "name": "TELLME EXE", "size": 55641, "date": "1992-01-31", "time": "16:52" }, { "name": "TELLPROT EXE", "size": 233343, "date": "1992-01-31", "time": "16:52" }, { "name": "VIOCALLS DLL", "size": 5647, "date": "1991-11-26", "time": "10:29" }, { "name": "BCC286 EXE", "size": 23076, "date": "1992-01-31", "time": "16:00" }, { "name": "KERNEL DLL", "size": 3458, "date": "1992-06-04", "time": "15:18" }, { "name": "KEYBOARD DLL", "size": 3458, "date": "1992-06-04", "time": "15:18" }, { "name": "USER DLL", "size": 3458, "date": "1992-06-04", "time": "15:18" } ] }, { "path": "/BC3", "files": [ { "name": "LIB", "dir": true, "date": "1992-10-01", "time": "18:38" } ] }, { "path": "/BC3/LIB", "files": [ { "name": "C0DLL OBJ", "size": 1362, "date": "1992-04-22", "time": "10:34" }, { "name": "C0PL OBJ", "size": 2389, "date": "1992-04-22", "time": "10:34" }, { "name": "C0PLDLL OBJ", "size": 2256, "date": "1992-04-22", "time": "10:34" }, { "name": "C0RLDLL OBJ", "size": 2104, "date": "1992-04-22", "time": "10:34" }, { "name": "DLL30 DEF", "size": 357, "date": "1991-12-10", "time": "18:23" }, { "name": "DLL30 LIB", "size": 20992, "date": "1992-04-22", "time": "16:07" }, { "name": "EMU286 LIB", "size": 3584, "date": "1992-04-22", "time": "15:34" }, { "name": "EXTMODS LBC", "size": 402, "date": "1992-04-21", "time": "15:04" }, { "name": "FP286 LIB", "size": 3584, "date": "1992-04-22", "time": "15:34" }, { "name": "FPDMY OBJ", "size": 317, "date": "1992-04-22", "time": "11:58" }, { "name": "GLUEBUFF ASM", "size": 584, "date": "1991-12-10", "time": "18:24" }, { "name": "GRPH30 LIB", "size": 36352, "date": "1992-04-22", "time": "16:07" }, { "name": "INSMODS LBC", "size": 540, "date": "1992-04-21", "time": "16:22" }, { "name": "MKGRAPH BAT", "size": 3398, "date": "1992-06-04", "time": "9:31" }, { "name": "MKLIB BAT", "size": 1927, "date": "1992-06-04", "time": "9:31" }, { "name": "PHAPI LIB", "size": 22171, "date": "1991-11-25", "time": "18:36" }, { "name": "REMOBJS BAT", "size": 475, "date": "1992-04-16", "time": "13:32" }, { "name": "TMPL LIB", "size": 19968, "date": "1992-04-28", "time": "14:36" } ] }, { "path": "/INC", "files": [ { "name": "PHAPI H", "size": 9300, "date": "1992-05-27", "time": "16:02" } ] }, { "path": "/EXAMPLES", "files": [ { "name": "BIG C", "size": 529, "date": "1992-05-27", "time": "11:21" }, { "name": "BIG EXE", "size": 24640, "date": "1992-06-04", "time": "10:50" }, { "name": "DOSMEM C", "size": 526, "date": "1992-05-27", "time": "11:27" }, { "name": "DOSMEM EXE", "size": 24164, "date": "1992-06-04", "time": "10:51" }, { "name": "FULLSCRN C", "size": 4864, "date": "1992-06-04", "time": "10:49" }, { "name": "FULLSCRN H", "size": 1622, "date": "1991-07-17", "time": "15:25" }, { "name": "KEYS C", "size": 3006, "date": "1991-08-06", "time": "19:14" }, { "name": "KEYS EXE", "size": 27316, "date": "1992-06-04", "time": "10:53" }, { "name": "MAKEALL BAT", "size": 9, "date": "1991-09-10", "time": "16:05" }, { "name": "MAKEFILE", "size": 472, "date": "1992-06-04", "time": "10:20" }, { "name": "MEMTEST C", "size": 710, "date": "1992-06-04", "time": "10:48" }, { "name": "MEMTEST EXE", "size": 24142, "date": "1992-06-04", "time": "10:51" }, { "name": "MEMTEST2 CPP", "size": 1155, "date": "1992-05-27", "time": "11:27" }, { "name": "MEMTEST2 EXE", "size": 32792, "date": "1992-06-04", "time": "10:52" }, { "name": "VIDTEST C", "size": 689, "date": "1992-06-04", "time": "10:49" }, { "name": "VIDTEST EXE", "size": 30318, "date": "1992-06-04", "time": "10:53" }, { "name": "HELLO C", "size": 239, "date": "1992-06-03", "time": "15:18" } ] }, { "path": "/DOC", "files": [ { "name": "LITE286 DOC", "size": 85476, "date": "1992-06-04", "time": "16:42" }, { "name": "ORDER FRM", "size": 1308, "date": "1992-06-04", "time": "15:48" }, { "name": "INTL DLR", "size": 1563, "date": "1992-06-02", "time": "16:48" }, { "name": "LITEINFO", "size": 3882, "date": "1992-06-04", "time": "16:18" }, { "name": "LICENSE DOC", "size": 5911, "date": "1992-05-28", "time": "16:54" } ] } ], "volume": "DISK 1" } }, "desc_file": "README.1ST", "desc_text": "\tInstallation Instructions for 286|DOS-Extender Lite (TM)\r\n\r\nPhar Lap Software, Inc.\r\n60 Aberdeen Ave.\t\tVoice: +1 617 661 1510\r\nCambridge, MA 02138\t\tFAX: +1 617 876 2972\r\n\r\nWelcome, and thank you for using Phar Lap's 286|DOS-Extender Lite.\r\nLite is a special, limited version of Phar Lap's award-winning\r\n286|DOS-Extender SDK designed exclusively for users of Borland C++\r\n3.1. If you enjoy using 286|DOS-Extender Lite, we hope that you will\r\nconsider purchasing our full-featured SDK.\r\n\r\nThese notes explain how to install Lite on your hard disk, provide a\r\nsimple description of building one of the example programs, and describe\r\nother documentation files on this diskette. A complete description of how\r\nto compile for protected mode can be found in LITE286.DOC, described below. \r\n\r\n*******************************************************************************\r\n\t\t\tOther Documentation\r\n*******************************************************************************\r\nThere are several other files which contain valuable information about\r\n286|DOS-Extender Lite. These files are located in the distribution\r\ndiskette in a directory called A:\\DOC, and are copied to \\LITE286\\DOC\r\nduring installation.\r\n\r\nLITE286.DOC contains \"Borland C++ User's Guide to 286|DOS-Extender Lite\".\r\nIt explains how to compile and run DOS-extended programs after installing\r\nLite. You may want to print this file and keep it handy as a reference\r\nwhile you are writing programs for Lite.\r\n\r\nLITEINFO is a short description of 286|DOS-Extender Lite, and contains\r\nan overview of the major differences between Lite and our full-featured\r\nSDK. It is identical to the text that is displayed if you run\r\nLITE286.EXE with no arguments or options.\r\n\r\nINTL.DLR contains a list of overseas dealers. If you are outside the\r\nUSA, please feel free to contact either Phar Lap or one of these dealers\r\nfor technical support or to order your 286|DOS-Extender SDK.\r\n\r\nORDER.FRM is a copy of the coupon included in the 286|DOS-Extender\r\nLite package.\r\n\r\n*******************************************************************************\r\n\t\t\tInstallation\r\n*******************************************************************************\r\nBefore installing 286|DOS-Extender Lite, you must have previously installed\r\nBorland C++ 3.1 on your hard drive. Please note that to use Lite, you need\r\nnot install the entire 3.1 release; only the command-line compiler and the\r\nDOS large-model libraries are required. If you wish to write protected-mode\r\ngraphics programs using the Borland Graphics Interface (BGI), then you must\r\nalso install that component. Lite does not require, and will not use, any of\r\nthe files installed by the \"Windows Options...\" menu.\r\n\r\nFor our examples, we assume you have installed Borland C++ in C:\\BORLANDC.\r\nIf you have installed it elsewhere, modify these instructions accordingly.\r\n\r\nInstalling 286|DOS-Extender Lite is a three-step process. First, you\r\nmust copy all of the files from the distribution diskette to your hard\r\ndrive. Second, you must build a special, protected-mode version of the\r\nC run-time library. Third, you may optionally build a special version\r\nof the graphics library. After you have completed each of these steps,\r\nyou are ready to start building protected mode applications!\r\n\r\n\r\nStep 1: Copy Files From Diskette\r\n--------------------------------\r\nTo copy the files from the diskette, insert the distribution diskette\r\nand type \"A:INSTALL\". The installation program will then ask you a\r\nseries of questions. You may either install Lite in the suggested\r\ndirectory or specify your own location. These instructions assume that\r\nyou install Lite in C:\\LITE286. If you have 286|DOS-Extender SDK, you\r\nshould *not* install Lite in the same directory as the SDK.\r\n\r\nIf you prefer not to use our interactive installation program\r\nA:INSTALL.EXE, you may copy the files with xcopy:\r\n\r\n\tC:\\> xcopy a:\\ c:\\lite286\\. /s\r\n\r\n\r\nStep 2: Build a Run-Time Library\r\n--------------------------------\r\nInstead of using the large-model real-mode CL.LIB that comes with\r\nBorland C++, 286|DOS-Extender Lite requires a protected-mode library\r\ncalled BCL286.LIB. BCL286.LIB is based on CL.LIB but contains some\r\nsmall but important modifications for protected mode. The batch\r\nprogram \\LITE286\\BC3\\LIB\\MKLIB.BAT creates BCL286.LIB from a copy of\r\nCL.LIB. The new library is created in \\LITE286\\BC3\\LIB. MKLIB.BAT\r\ndoes not in any way modify files in the \\BORLANDC directory tree.\r\n\r\nMKLIB.BAT should be executed while \\LITE286\\BC3\\LIB is the current directory:\r\n\r\n\tC:\\> cd \\lite286\\bc3\\lib\r\n\tC:\\LITE286\\BC3\\LIB> mklib l \\borlandc\\lib\r\n\r\nMKLIB.BAT invokes LIB.EXE from Borland C++ 3.1 -- if MKLIB.BAT fails,\r\ncheck that you installed Borland C++ correctly, and that \\BORLANDC\\BIN\r\nis in your PATH environment variable.\r\n\r\nStep 3: Build a Graphics Library\r\n--------------------------------\r\nProtected-Mode Lite programs can call the Borland Graphics\r\nInterface (BGI). Just as a special version of the C library\r\nmust be built, you must build a special version of the graphics\r\nlibrary.\r\n\r\nThe batch program which does this is \\LITE286\\BC3\\LIB\\MKGRAPH.BAT:\r\n\r\n\tC:\\LITE286\\BC3\\LIB> mkgraph \\borlandc\\lib\r\n\r\n\r\n*******************************************************************************\r\n\t\t\tBuilding Sample Executables\r\n*******************************************************************************\r\nTo simplify building protected-mode executables, we provide\r\n\\LITE286\\BIN\\BCC286.EXE. BCC286 acts as a \"front-end\" to BCC.EXE and\r\nTLINK.EXE, providing them with all the proper options and arguments. For\r\ncomplete documentation on BCC286.EXE, consult the file LITE286.DOC.\r\n\r\nBCC286.EXE uses certain environment variables to control its operations.\r\nThese variables are not strictly required, but we will use them in this\r\ndemonstration.\r\n\r\nThe LIB environment variable contains a list of directories in which to\r\nsearch for libraries and startup object modules. This list must include\r\nLite's library directory in addition to Borland C++'s.\r\n\r\nThe PATH environment variable must include both Lite's executable directory\r\nand Borland C++'s.\r\n\r\n\tC:\\LITE286\\EXAMPLES> set LIB=\\lite286\\bc3\\lib;\\borlandc\\lib\r\n\tC:\\LITE286\\EXAMPLES> set PATH=\\dos;\\lite286\\bin;\\borlandc\\bin\r\n\tC:\\LITE286\\EXAMPLES> bcc286 hello.c\r\n\tC:\\LITE286\\EXAMPLES> hello.exe\r\n\tHello from protected mode!\r\n\r\nWhen compiling a program that uses BGI for real mode you link against\r\nGRAPHICS.LIB. For protected mode, the library to use is GRAPH286.LIB.\r\nAssuming the environment variables are still set as above, then building\r\na protected-mode BGIDEMO.EXE is as simple as:\r\n\r\n\tC:\\LITE286\\EXAMPLES> bcc286 bgidemo.c graph286.lib\r\n\r\nLITE286.DOC provides complete details of the build process; it also\r\ndescribes LITE286.EXE and GORUN286.EXE, the programs which actually\r\nload and execute your program in protected mode.\r\n\r\n*******************************************************************************\r\n\t\t\t\tWhat Next?\r\n*******************************************************************************\r\nYou have now completely installed 286|DOS-Extender Lite, and are ready to\r\nbuild multi-megabyte programs. Please read the file LITE286.DOC for more\r\ninformation on protected-mode programming.\r\n\r\nWe sincerely hope that you find 286|DOS-Extender Lite both useful and\r\neasy to use. If Lite makes you more productive, then consider what our\r\nfull-featured 286|DOS-Extender SDK can do for you! Ordering information\r\nis contained in the files LITEINFO, ORDER.FRM, and INTL.DLR." }