home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Professional / OS2PRO194.ISO / os2 / wps / graphic / videodrv / videodrv.doc < prev    next >
Text File  |  1993-11-14  |  18KB  |  389 lines
  1.           DOCUMENTATION FOR VIDEO DRIVER INSTALL v5.00
  2.           ---------------------------------------------
  3.           (c)1993, Dr. A. Olowofoyeku
  4.  
  5.  
  6. INTRODUCTION
  7. ------------
  8.  
  9. Please read the "LIMITATIONS" and "DISCLAIMER" sections at the end of this
  10. file BEFORE using VIDEODRV.
  11.  
  12. While it is possible for OS/2 users to use different video display drivers
  13. for their seamless and full screen Win-OS/2 sessions, the OS/2 installation
  14. and DSPINSTL programs always identical drivers for both sessions. While this
  15. may be fine for some people, many OS/2 users have optimized Windows drivers
  16. that they would like to use for their full screen Win-OS/2 sessions. The
  17. process of changing the video display drivers for full screen Win-OS/2
  18. sessions has normally been tedious, involving fiddling around with INI
  19. files.
  20.  
  21. VideoDrv is a program that greatly simplifies this process - just type in
  22. the name of your new full screen driver, or select one from a listbox, then
  23. click on a button, and the rest is done automatically. The whole process
  24. takes no more than 5 seconds. In short, VIDEODRV works as a Win-OS/2
  25. replacement for the SETUP program that comes with Windows 3.1.
  26.  
  27.  
  28. ********
  29. FEATURES
  30. ********
  31.  
  32. 1. VIDEODRV will optionally install your display driver directly
  33.    from your driver/distribution disk, unpacking and decompressing them (if
  34.    necessary) in the process. In this respect, it simulates the SETUP
  35.    program that comes with Windows 3.1. To use this feature, select the menu
  36.    option "INSTALL NEW DRIVER FROM DISK". You will then be prompted for the
  37.    directory in which your driver files are to be found (this will normally
  38.    be a floppy disk drive into which your driver disk has been inserted, or
  39.    if you have copied the files to the hard disk, then the subdirectory on
  40.    the hard disk where the files may be found).
  41.  
  42.    VIDEODRV will then read the OEMSETUP.INF file that comes with your driver
  43.    disk and decompress the drivers to your Win-OS/2 system directory. Some
  44.    OEMSETUP.INF files may not be readily readable (and I only have access to 
  45.    a finite number of OEMSETUP files). If there is any problem with your
  46.    manufacturer's version of the file, do please mail me a copy.
  47.  
  48.    NOTE that if you downloaded your drivers from a bulletin board or from an
  49.    ftp site, you need to unzip the files first. VIDEODRV will NOT unzip files
  50.    that have been archived in the ZIP format.
  51.  
  52.  
  53. 2. When you have installed your drivers from a driver disk, VIDEODRV will
  54.    create a file in your DRIVER DIRECTORY (see below) called VIDEODRV.DBF.
  55.    This file will hold information on all the drivers that you have
  56.    installed through VIDEODRV from a driver disk. Thus, if you want to
  57.    change the drivers, you will be presented with a list of the descriptions
  58.    of the drivers (not just the file names as in early versions of
  59.    VIDEODRV). When you select from the list, the appropriate driver will be
  60.    installed.
  61.  
  62.    Please NEVER delete VIDEODRV.DBF, otherwise, VIDEODRV will just assume
  63.    that you have not installed any driver from a driver disk as described
  64.    above, and will only present you with a list of driver filenames.
  65.  
  66. 3. VIDEODRV will put a copy of each installed driver into your DRIVER
  67.    DIRECTORY. This is to facilitate future driver changes.
  68.  
  69.  
  70. 4. There is a menu option which you can select to RESTART the Win-OS/2
  71.    session. Also, when you have just changed your display driver or
  72.    installed a new one, VIDEODRV can optionally restart the Win-OS/2
  73.    session. You should use this option only if you are already running in a
  74.    full screen session.
  75.  
  76.  
  77. ***************************
  78. ** NEW WITH VERSION 5.00 **
  79. ***************************
  80.  
  81. 6. Well, there is yet a new file format for VIDEODRV.DBF. Actually, it is
  82.    just the same old file format, but I have added yet more information to
  83.    the file, as I add new features internally. Thus, there is a new 
  84.    CONVERT.EXE which converts VIDEODRV.DBF from the version 4.00 format
  85.    to the version 5.00 format. Please note that you should only use the
  86.    CONVERT.EXE that is supplied with version 5.00 if you are using version
  87.    4.00. If you are using an earlier version (assuming you have not been
  88.    using it for more than the 30 day evaluation period) then you basically
  89.    need to delete your VIDEODRV.DBF file, and reinstall your drivers files
  90.    again for the purpose of building a new VIDEODRV.DBF.
  91.  
  92.    CONVERT.EXE is text mode OS/2 program that should be run from a command prompt
  93.    (after changing to the directory in which your VIDEODRV.DBF file is located).
  94.  
  95.    CONVERT.EXE is really a half-way solution, because the information in the
  96.    old DBF file is less than that in the new file. All that CONVERT.EXE does
  97.    is to put that information into the new file format. By using it, you
  98.    will not get the benefits of the extra information in the new file format
  99.    (this basically concerns updating references to fonts in the Win-OS/2 INI
  100.    files). Please note this point.
  101.  
  102.    CONVERT.EXE converts the data in VIDEODRV.DBF and puts it into a file
  103.    called CONVERT.DBF. After conversion, you need to back up your old
  104.    VIDEODRV.DBF, delete the copy on your hard disk, and then rename
  105.    CONVERT.DBF to VIDEODRV.DBF.
  106.  
  107.  
  108.  
  109. INSTALLATION
  110. ------------
  111.  
  112. There is no special installation procedures. Just copy the following files;
  113. 1. VIDEODRV.EXE     (the executable)
  114. 2. VIDEODRV.INI     (the initialization file)
  115. 3. VIDEODRV.DOC     (this file)
  116. 4. LZEXPAND.DLL     (library file for decompressing driver files)
  117.                     - you may already have LZEXPAND.DLL in your Win-OS/2
  118.                       system directory. If so, then you do not need to copy
  119.                       the version supplied with this program.
  120.  
  121. into any sub-directory. Then create a WPS object for VIDEODRV.EXE, or add it
  122. to one of your Program Manager groups.
  123.  
  124.  
  125. USE
  126. ---
  127.  
  128. Please read the DISCLAIMER at the end of this file BEFORE any attempt to use
  129. VideoDrv.
  130.  
  131. As indicated above, VIDEODRV will now unpack driver files directly from a
  132. manufacturer's driver distribution diskette, or from any directory into
  133. which the driver files have been copied.
  134.  
  135. In order to run VIDEODRV properly, I recommend strongly, that;
  136.  
  137.   [a] you should create a special DRIVER DIRECTORY into which your full
  138.       screen Win-OS/2 drivers will always be installed.
  139.  
  140.         e.g., C:\DRIVERS
  141.  
  142.   [b] the name of that directory should be placed on the line
  143.       "DRIVER-DIRECTORY=" in the file VIDEODRV.INI. This is actually the
  144.       only entry in this INI file, and should be used.
  145.  
  146.        e.g., DRIVER-DIRECTORY=C:\DRIVERS
  147.  
  148.   [c] all the drivers that may be used for full screen Win-OS/2 sessions
  149.       should be copied into the driver directory. This is done automatically
  150.       when you use VIDEODRV to install drivers.
  151.  
  152.   [d] click on the button labelled "Browse", or the button labelled
  153.       "List .DRV files, to get a list of the driver files in this directory,
  154.       from which one can be selected.
  155.  
  156.   If there is no entry on the "DRIVER-DIRECTORY=" line (in VIDEODRV.INI), or
  157.   if a non-existent directory is specified, then VideoDrv will always
  158.   default to your Win-OS/2's SYSTEM directory. The problem with this
  159.   approach is that there are *many* files in the Win-OS/2 SYSTEM directory
  160.   that have the extension ".DRV". Most of them are NOT video display drivers
  161.   at all, and some of the ones which are video display drivers are not
  162.   suitable for full screen Win-OS/2 sessions (typically, the ones used for
  163.   seamless Win-OS/2). Thus, selecting any of these will lead to
  164.   unpredictable results.
  165.  
  166.   This is why it is *highly recommended* that all your special Windows
  167.   screen drivers should be placed or copied into a separate directory. When
  168.   any of them is selected from the list, VideoDrv will copy it from this
  169.   directory into your Win-OS/2 SYSTEM directory, so that Win-OS/2 can find
  170.   it when loading.
  171.  
  172.  
  173. CHANGING VIDEO DISPLAY DRIVERS
  174. ------------------------------
  175. To change your full screen driver, select "New display driver" from the
  176. "File" menu. This leads to a dialog box which asks for the details of the
  177. new video display driver. This dialog box displays the NAME of the CURRENT
  178. full screen display driver, and any DESCRIPTION for it that exists in the
  179. INI files. The cursor is placed in an edit field into which you type the
  180. name of the new driver.
  181.  
  182. NOTE:
  183. -----
  184. 1. If you are sure that the driver already exists in the Win-OS/2 SYSTEM
  185.    directory, you can just type its name into this field. NOTE that only the
  186.    name of the file is to be typed in here. There should be no directory
  187.    path, or anything else.
  188.  
  189.    For example, "ET4000.DRV" is acceptable, if that file exists in the
  190.    Win-OS/2 SYSTEM directory. However, "C:\OS2\MDOS\WINOS2\WIN31\ET4000.DRV"
  191.    is NOT acceptable. In any case, VideoDrv will not allow more than 12
  192.    characters in this field.
  193.  
  194.    After typing the name of the driver, if you want to type in a description
  195.    for that driver, click on the next edit field, and type your description
  196.    there. This description is optional. However, if you do type in a 
  197.    description here, then VIDEODRV will add this to the entries in the file
  198.    VIDEODRV.DBF in your driver directory. If no description is typed in,
  199.    no entry will be made for the driver in VIDEODRV.DBF.
  200.  
  201.  
  202. 2. If you are not sure whether the driver is in the Win-OS/2 SYSTEM
  203.    directory or not, or if you wish to select a driver from a list, then
  204.    click on the "List .DRV Files" button. Then select the required driver
  205.    from the list of DRV files. The name of the driver you selected will
  206.    appear in the edit field, and the cursor will be moved to the next field,
  207.    into which you can type in a description for the new driver. This is
  208.    optional.
  209.  
  210.    If you have used VIDEODRV to install driver files from your driver
  211.    disk, then you can click on the "Browse" button. This will show you
  212.    a list of drivers that you have installed in this way (a full decription
  213.    of the drivers), and then you can select one of them.
  214.  
  215.  
  216. 3. When everything is complete, click on the button labelled "Write the
  217.    changes", and the new driver is installed for you full screen Win-OS/2.
  218.    It will take effect when you next run a full screen Win-OS/2 session.
  219.    At this point you will be asked if you want VIDEODRV to RESTART Win-OS/2
  220.    to see the results of your new driver. If you are running a full screen
  221.    Win-OS/2 session, you should click on the "YES" button. If you are running
  222.    a seamless session, then you should click on "NO", and start a full screen
  223.    session manually.
  224.  
  225.  
  226.  
  227. DESCRIPTION OF MENU OPTIONS
  228. ---------------------------
  229.  
  230. 1. CHANGE DISPLAY DRIVER
  231.    ---------------------
  232.    Choose this option to replace your current full screen driver with another
  233.    one to be selected from the driver files in your DRIVER-DIRECTORY. When
  234.    this option is selected, a dialog box appears. You can either type in the
  235.    name of the driver file you want, or click on one of the buttons for
  236.    assistance. The buttons on this dialog box are;
  237.        [a] BROWSE - this will open the file VIDEODRV.DBF and present you with
  238.                     a list of the drivers that you have installed from a
  239.                     driver disk. What you get here is a full description of
  240.                     the drivers. There are appropriate error messages if the
  241.                     file is not found, etc.
  242.  
  243.                     When you double click on one of the drivers in the list,
  244.                     the approprate driver file name is transferred into the
  245.                     edit field, and then you have to click on the button
  246.                     labelled "Write the changes".
  247.  
  248.        [b] LIST .DRV FILES - this presents you with just a list of the files
  249.                     with a .DRV extension. You can then select a file from
  250.                     the list. When this is done, the filename gets
  251.                     transferred to the edit field, and then you have to
  252.                     click on the button labelled "Write the changes".
  253.  
  254.  
  255.        [c] ABANDON - abandon the installation process.
  256.  
  257.        [d] WRITE THE CHANGES - writes whatever is in the edit fields into the
  258.                     appropriate INI files. If the field for the driver name
  259.                     is empty, then you will get an error message.
  260.  
  261.  
  262. 2. INSTALL NEW DRIVER FROM DISK
  263.    ----------------------------
  264.    Select this option when you want to unpack your drivers from your driver
  265.    disk. You will be prompted for the directory in which the files from the
  266.    distribution disk can be found. Then the file OEMSETUP.INF will be read
  267.    for the installation information. After this, there will appear a list
  268.    box containing descriptions of the drivers found on the disk. You can then
  269.    double click on any of them to unpack and install them in one go.
  270.  
  271.  
  272. 3. SHELL TO DOS
  273.    ------------
  274.    This option opens a DOS box. It is useful for the purpose of maybe
  275.    unzipping files, etc. Type "exit" to close the DOS box.
  276.  
  277.  
  278. 4. RESTART WIN-OS/2 SESSION
  279.    ------------------------
  280.    This option closes down the current Win-OS/2 session, and RESTARTS the
  281.    session again. You will be prompted for confirmation. You should use this
  282.    option only if you are already running in a full screen session.
  283.  
  284.  
  285. 5. QUIT WIN-OS/2 SESSION
  286.    ---------------------
  287.    This option closes down the current Win-OS/2 session. You will be
  288.    prompted for confirmation.
  289.  
  290.  
  291. LIMITATIONS
  292. -----------
  293. VIDEODRV has developed the proverbial "middle-age spread" since version
  294. 1.00. As I have added features to it, the more the program has grown in
  295. size. I do not wish it to grow any further, and there are many things I have
  296. decided not to implement.
  297.  
  298. 1. The first is installing from multiple floppy disks. If all the files
  299.   relating to your driver are on one floppy disk, then that is fine. If they
  300.   span a number of floppy disks, then you need to copy all the files into a
  301.   directory on your hard disk and install from there.
  302.  
  303. 2. Some OEMSETUP.INF files prefer certain fonts to be copied from the
  304.    Microsoft Windows 3.1 distribution disks. VIDEODRV will not copy these
  305.    font files, since my main purpose in writing it is to enable OS/2 users
  306.    to install their video drivers WITHOUT using MS-Windows at all. If people
  307.    have MS-Windows 3.1, then they can run its SETUP program instead.
  308.  
  309.    Usually, these fonts would have been copied to your MS-Windows 3.1 system
  310.    anyway, if you have actually installed MS-Windows 3.1. They are mainly
  311.    fixed monospaced fonts.
  312.  
  313.    If you want to be doubly sure, you can;
  314.  
  315.    [a] copy all the files with a .FON extension from your MS-Windows 3.1
  316.        distribution disks into a directory on your hard disk, and then
  317.    [b] copy the files from your manufacturer's driver distribution disk into
  318.        the same directory AFTERWARDS (this way you won't overwrite your
  319.        manufacturer's fonts with MS ones that have the same name), and then
  320.    [c] install your drivers from this directory.
  321.  
  322.    This method will work because VIDEODRV will try to install all the fonts
  323.    that your OEMSETUP.INF file tells it to. It will ONLY look for these
  324.    fonts in the directory from which you are installing, and if it doesn't
  325.    find any font, it simply goes on with the rest.
  326.  
  327.  
  328. LICENSE
  329. -------
  330. VideoDrv is supplied as a shareware program. You may copy and
  331. distribute this program freely, PROVIDED THAT *all* the accompanying
  332. files are included.
  333.  
  334. If you have used VideoDrv for 30 days, and wish to continue using it,
  335. then you are obliged to REGISTER your copy. The REGISTRATION fee is
  336. VERY small, and I am relying on users to play fair. The program
  337. is not crippled or disabled in anyway.
  338.  
  339. The registration fee is ú5 (Five Pounds Sterling), or $US7.50 (Seven (US)
  340. Dollars and Fifty Cents). If you are registering in currency other than
  341. British Pounds Sterling, please send an International Money Order, or CASH.
  342. Sending me a cheque drawn out in foreign currency is *worse* than USELESS,
  343. since the bank charges will be more than the amount you are sending.
  344. Please note this point.
  345.  
  346. Please send your REGISTRATION FEE to me at the following address;
  347.  
  348.      Dr. A. Olowofoyeku
  349.      268 Horwood
  350.      Newcastle
  351.      Staffs ST5 5BQ
  352.      England.
  353.  
  354.      E-mail: laa12@seq1.keele.ac.uk
  355.  
  356.  
  357. REGISTRATION brings the following benefits;
  358.  
  359. 1. The satisfaction of being an honest person
  360. 2. Support for the program - I will not answer any questions from anybody
  361.    who has not registered.
  362. 3. The knowledge that you are encouraging shareware programmers to cater
  363.    for OS/2 users.
  364.  
  365. If you think that VIDEODRV is not worth the registration fee, then please
  366. DELETE it from your disks.
  367.  
  368.  
  369. BUG REPORTS AND SUGGESTIONS
  370. ---------------------------
  371. Please let me know of any bugs, or any suggestions for improvement of the
  372. program. I am developing and improving on VIDEODRV virtually on a daily
  373. basis (which must be evident from the number of updates that I keep
  374. uploading to the OS/2 ftp sites).
  375.  
  376.  
  377. **************
  378. * DISCLAIMER *
  379. **************
  380. THE PROGRAM VIDEODRV IS SUPPLIED "AS IS", AND WITHOUT ANY WARRANTIES
  381. WHATSOEVER. YOU USE THIS PROGRAM ENTIRELY AT YOUR OWN RISK. I WILL NOT
  382. ACCEPT ANY RESPONSIBILITY FOR ANY LOSS OR DAMAGE, WHETHER PHYSICAL,
  383. FINANCIAL, EMOTIONAL, SOCIAL, MENTAL, MARITAL, OR OTHERWISE, THAT MAY
  384. RESULT FROM THE USE, OR THE PURPORTED USE, OF VIDEODRV, FOR ANY PURPOSE
  385. WHATSOEVER.
  386.  
  387. IF THESE TERMS ARE NOT ACCEPTABLE TO YOU, THEN YOU HAVE NO LICENSE TO USE
  388. VIDEODRV, AND YOU SHOULD DELETE IT FROM YOUR DISKS IMMEDIATELY.
  389.