home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 33 VDrivers / 33-VDrivers.zip / smallf13.zip / readme.txt < prev   
Text File  |  1995-03-06  |  16KB  |  470 lines
  1.  
  2.  
  3. SMALL FONTS AND ICONS FOR OS/2 WARP SVGA DISPLAY DRIVERS
  4. --------------------------------------------------------
  5.  
  6.  
  7.  
  8.                     Version 1.3
  9.                     -----------
  10.  
  11.  
  12.  
  13. ** Please take time to read the disclaimer located  **
  14. ** at the bottom of this file.                      **
  15.  
  16.  
  17. Introduction
  18. ------------
  19.  
  20. The SVGA display drivers from IBM have an annoying habit of using
  21. large icons and fonts at resolutions above and including 1024x768.
  22.  
  23. The program contained within this archive was written to address this
  24. problem by making alterations to the display drivers to give small
  25. fonts and icons.
  26.  
  27. This latest version of smallfix should address many of the problems
  28. reported by users of more exotic display drivers.  smallfix now allows
  29. users to use a simple interface to patch drivers that smallfix doesn't
  30. have in its internal database.
  31.  
  32. VERY IMPORTANT: 
  33.   SMALLFIX WILL *NOT* ALTER THE WINDOWS(tm) OR SEAMLESS WINDOWS(tm)
  34.   DRIVERS IN ANY WAY, SHAPE, OR FORM.  YOU WILL CONTINUE TO HAVE LARGE
  35.   FONTS AND ICONS IN WINDOWS SESSIONS AFTER RUNNING FIXDISP ON YOUR
  36.   OS/2 DRIVERS.
  37.  
  38. (I don't have any solution for this).
  39.  
  40. Please feel free to hassle IBM about these large fonts and icons.  I
  41. don't know anyone who actually prefers them.  I can only assume that
  42. the IBM OS/2 programmers aren't inflicted with them, or this problem
  43. would have been resolved by now.
  44.  
  45. smallfix will probably work with OS/2 2.1, OS/2 2.11, and Warp Beta
  46. drivers as well.
  47.  
  48.  
  49. Procedure
  50. ---------
  51.  
  52. NB: If you encounter problems at any stage, skip down to the
  53.     trouble shooting section below.
  54.  
  55.     You might also like to print out this readme before starting.  You
  56.     should also read this entire file first.
  57.  
  58.  
  59. 1. Install the high resolution drivers using Selective Install or your
  60.    display card manufacturer's installation disks if you haven't
  61.    already done so.
  62.  
  63.  
  64. 2. The first and most important thing to do is to take a backup of the
  65.    display driver DLL that smallfix is going to attack.  This DLL will
  66.    be located in \OS2\DLL on your OS/2 boot drive.  Possible names for
  67.    this DLL include:
  68.  
  69.    IBMS332.DLL   IBMDEV32.DLL   ATIM32.DLL  ATI6432.DLL  M6432.DLL
  70.    TLIW32PM.DLL  CIRRUS.DLL     MGA32.DLL   8514_32.DLL  IBMXGA32.DLL
  71.  
  72.    The DLL will probably be about 350k in size.
  73.  
  74.    Take a backup of this DLL by copying it to a new file in the
  75.    \OS2\DLL directory.  I recommend that you either prefix an "old-"
  76.    to the DLL name (if on HPFS) or change the .DLL suffix to .OLD.
  77.  
  78.    eg.
  79.       [D:\OS2\DLL] copy ibms332.dll ibms332.old
  80.    or 
  81.       [D:\OS2\DLL] copy ibms332.dll old-ibms332.dll
  82.  
  83.    Also sticking a copy on floppy disk won't hurt.
  84.  
  85.  
  86. 3. Run fixdisp.exe in an OS/2 command window.
  87.  
  88.  
  89. 4. When prompted, enter the path to the \OS2\DLL directory.
  90.  
  91.    eg.
  92.  
  93.        Enter path to OS/2 DLL directory (eg. C:\OS2\DLL) : D:\OS2\DLL
  94.        ... using D:\OS2\DLL
  95.  
  96.    fixdisp will now scan the directory for DLLs that it knows about.
  97.    If it finds any, it will display a list like this:
  98.  
  99.        This is a list of possible DLLs to patch:
  100.        >> ibms332.dll << (already patched)
  101.        >> old-ibms332.dll << -- 32 Bit S3 Display Drivers V2.4 -- (try this)
  102.  
  103.    The comment in parentheses is reasonably important.  It can be one
  104.    of the following:
  105.  
  106.      already patched    - the DLL is patched already
  107.      try this           - the DLL is known about by fixdisp
  108.      possible           - fixdisp knows can't reliably patch the DLL
  109.                           automatically, but will help you to do it.
  110.  
  111.   If you do not get a list of DLLs like the one shown above, then DO
  112.   NOT PANIC!  Assuming that you know or can guess the DLL name
  113.   yourself, then fixdisp will guide you through the patching process.
  114.  
  115.  
  116. 5. Enter the name of the DLL file to be patched.  Use the backed up
  117.    .DLL (old-<dllname>.dll, or <dllname>.old).
  118.  
  119.    eg.
  120.      (Don't bother trying svga.dll here!)
  121.      Enter the name (without path) of the DLL to patch : old-ibms332.dll
  122.      ... using old-ibms332.dll
  123.  
  124.    NB: svga.dll may sound like a promising display driver name, but
  125.    the chances of getting small fonts and icons as a result of
  126.    patching it are about 0%.  Trust me on this.  :-)
  127.  
  128.  
  129. 6. Enter the name of the file that will contain the patched DLL.  I
  130.    recommend new-<dllname>.dll or <dllname>.new.
  131.  
  132.    eg.
  133.      Enter the name (with path) for the patched DLL : D:\OS2\DLL\new-ibms332.dll
  134.  
  135.  
  136. 7. If the display driver DLL is one that is recognised by fixdisp's
  137.    internal database, then you'll get a message like this:
  138.  
  139.      Use built-in patch information rather than the patch locator? [Y/N] :
  140.  
  141.    If you respond "Y" to this, then fixdisp will attempt to patch the
  142.    DLL using information in its database.  You should probably reply
  143.    "Y" to this prompt.  If the automatic patch doesn't work for some
  144.    reason, or you like life on the edge, then respond with "N" and
  145.    fixdisp will guide you through the manual patching process.
  146.  
  147.    If you don't get given this prompt, or you respond with "N", then you
  148.    will be taken to the patch locator.  Skip to step 9.
  149.  
  150.  
  151. 8. On responding "Y", the following should (hopefully) appear:
  152.  
  153.      ... using built-in patch information...
  154.  
  155.      1024x768 font patch made...
  156.      1280x1024 font patch made...
  157.      DPI patch made...
  158.      32x32 icon patch made...
  159.  
  160.      Saving patched DLL to D:\OS2\DLL\new-ibms332.dll... done.
  161.  
  162.    NB: If you want to use 1280x1024 small fonts, and the patch made
  163.    message does not appear for them, then run fixdisp again, but
  164.    respond "N" to the automatic patch prompt in step 7.
  165.  
  166.    Skip to step 10.
  167.  
  168.  
  169. 9. The patch locator:
  170.  
  171.    You may require a pen and paper here... :-)
  172.  
  173.      --- PATCH LOCATOR ---
  174.  
  175.    The patch locator enables you to manually patch the DLL.  There is
  176.    no 100% bulletproof method of patching every display driver, so
  177.    there may be several possible choices for each type of patch.  The
  178.    bad news is that picking the wrong one will probably cause your
  179.    machine to halt or trap when the patched display driver is loaded.
  180.    More on that later though.
  181.  
  182.    For each of the four patches (2 fonts, dpi, and icons), you will be
  183.    prompted with a list of possible patch locations.  The one which
  184.    fixdisp thinks is most likely to be the right one will be marked
  185.    with an asterisk (this is the choice that previous versions of
  186.    fixdisp would use).  If there isn't an asterisk for any of the four
  187.    patch types, or there aren't any choices available, then you might
  188.    be using the wrong DLL!
  189.  
  190.    It's helpful to note down your choice on a piece of paper so that
  191.    if you have to run fixdisp again you will know which choices
  192.    you have tried.
  193.  
  194.    Enter the location number you want to try.  Always try the
  195.    asterisked locations first.  You can omit a patch by entering 0.
  196.    This would enable you to experiment with getting the icons working
  197.    before you try the fonts.
  198.  
  199.    An example of this process: (the number of choices, and the values
  200.    displayed will probably be different for you)
  201.  
  202.      1024x768 font patch location:  (* = most likely)
  203.      * 1. 1ff0e
  204.        2. 2643a
  205.        3. 4b5f6
  206.        4. 561a3
  207.        0. <don't patch>
  208.  
  209.      Which one do you want to try? : 1  <-- input
  210.      ... location 1 at offset 1ff0e will be patched.
  211.  
  212.      1280x1024 font patch location:  (* = most likely)
  213.      * 1. 1fed6
  214.        2. 51b03
  215.        3. 55741
  216.        0. <don't patch>
  217.  
  218.      Which one do you want to try? : 1 <-- input
  219.      ... location 1 at offset 1fed6 will be patched.
  220.  
  221.      DPI patch location:  (* = most likely)
  222.        1. 325
  223.      * 2. 2dd18
  224.        3. 54390
  225.        4. 54646
  226.        5. 548f2
  227.        6. 54be4
  228.        7. 55761
  229.        8. 55ca1
  230.        0. <don't patch>
  231.  
  232.      Which one do you want to try? : 2 <-- input
  233.      ... location 2 at offset 2dd18 will be patched.
  234.  
  235.      32x32 icon patch location:  (* = most likely)
  236.      * 1. 55167
  237.        0. <don't patch>
  238.  
  239.      Which one do you want to try? : 1 <-- input
  240.      ... location 1 at offset 55167 will be patched.
  241.  
  242.      Saving patched DLL to D:\OS2\DLL\new-ibms332.dll... done.
  243.  
  244.      If these values create a working DLL with small fonts and icons
  245.      then the following line can be entered into the fixdisp.db file for future
  246.      use (alter the .DLL name to conform to the naming conventions in fixdisp.db).
  247.      A copy of this line has been appended to fixdisp.log.
  248.  
  249.      old-ibms332.dll,0xd86a556a,0xd06d0ca2,0x1ff0e,0x1fed6,0x2dd18,0x55167
  250.  
  251.  
  252.    The last thing fixdisp does is to give you a line which describes
  253.    the patches it has made.  Rather than mail this line to me, feel
  254.    free to use it in a reply to a Usenet posting made by someone trying
  255.    to get a particular driver to work.
  256.  
  257.  
  258. 10. If you get here, then fixdisp should have written the patched DLL
  259.     to the file you specified in step 6.
  260.  
  261.     If it hasn't, then skip to the troubleshooting section below.
  262.  
  263.     The next step is to test the patched DLL.  Shutdown OS/2, and
  264.     reboot.  During startup, a white brick and the word "OS/2" will
  265.     appear briefly at the top left of the screen.  Press ALT-F1 when
  266.     this happens.
  267.  
  268.     After a couple of seconds, you will be presented with a menu.
  269.     Press C to boot to a command prompt.
  270.  
  271.     At the command prompt, change directory to the \OS2\DLL directory
  272.     on your boot drive.  Copy the patched DLL file (as entered in step
  273.     6) over the top of the display driver DLL.  YOU HAVE TAKEN A
  274.     BACKUP HAVEN'T YOU?
  275.  
  276.     eg.
  277.       [D:\] cd \os2\dll
  278.       [D:\OS2\DLL] copy new-ibms332.dll ibms332.dll
  279.       or
  280.       [D:\OS2\DLL] copy ibms332.new ibms332.dll
  281.  
  282.     From now on, if you need to re-run fixdisp, you should use
  283.     "old-<dllname>.dll" or "<dllname>.old" as the DLL filename to
  284.     patch, *NOT* "<dllname>.dll".
  285.  
  286.     Reboot thy computing device.
  287.   
  288.     eg.
  289.       [D:\OS2\DLL] exit
  290.  
  291.  
  292.     (NB: fixdisp.exe can be run from this maintenance shell if you 
  293.          prefer.)
  294.  
  295. 11. Your machine will now reboot, and with any luck, will have small
  296.     fonts and icons at 1024x768 and above.  Exactly which patches take
  297.     effect depends on whether you used the automatic or manual
  298.     patching (and maybe omitted some patches) in step 7.
  299.  
  300.     This isn't an ideal world (and OS/2 is an IBM program), so your
  301.     machine might hang or TRAP (most likely in SingleQ$) when it
  302.     attempts to change mode.  If this happens, then you need to reboot
  303.     back to the command line prompt from the boot menu, and restore
  304.     your original DLL.
  305.  
  306.     eg.
  307.       [D:\OS2\DLL] copy old-ibms332.dll ibms332.dll
  308.  
  309.     Reboot, and skip to the trouble shooting section below.
  310.  
  311.  
  312.  
  313. TROUBLE SHOOTING
  314. ----------------
  315.  
  316. 1. Fixdisp problems
  317.  
  318.    fixdisp will report any errors it encounters while attempting to
  319.    patch the display driver DLLs (missing files, etc).  If you come 
  320.    across errors/crashes in fixdisp itself, then let me know.
  321.  
  322.  
  323. 2. I don't know which DLL to patch!
  324.  
  325.    Let me know which drivers or card you have, and I'll try to help.
  326.  
  327.    First though, look in \OS2\DLL for a DLL with one of the names
  328.    listed in procedure step 2 above, and try using that.
  329.  
  330.  
  331. 3. Some of my applications look strange!
  332.  
  333.    There are several applications which have rather disorganised
  334.    displays after smallfix has been used.  These include IBM's media
  335.    players and the shareware Albatross CD player.  Given IBM's
  336.    inability to follow any of their own programming guidelines, I
  337.    suspect that these problems are caused by incorrect assumptions
  338.    about what size the default font is, or display size to DPI ratios.
  339.    There is nothing I can do about these applications; sorry.
  340.  
  341.    [ The LaunchPad actually looks better after smallfix has been used ]
  342.  
  343.    On the other hand, if all your applications and settings notebooks
  344.    look wrong, then one of the patches (probably DPI) hasn't been made
  345.    properly.  Proceed to number 4!
  346.  
  347.  
  348. 4. Display driver problems
  349.  
  350.    The most common problem users will encounter with fixdisp is an
  351.    inability to boot their machine once they have patched the driver
  352.    DLL and followed the instructions up to step 10.
  353.  
  354.    The most important thing to do first is to restore the machine to a
  355.    bootable state.  There are two ways of doing this:
  356.  
  357.      a) Use the OS/2 boot menu (hit ALT-F1 when the white brick
  358.      appears during a reboot), go to the command line (hit C), and do
  359.      the following:
  360.  
  361.     [D:\] cd \os2\dll 
  362.         [D:\OS2\DLL] copy old-ibms332.dll ibms332.dll 
  363.         or
  364.         [D:\OS2\DLL] copy ibms332.old ibms332.dll 
  365.  
  366.     Substitute the name of your driver DLL for the ibms332 bits
  367.         above.
  368.  
  369.      Reboot.  If OS/2 still won't start properly, then try step (b)
  370.      below.
  371.  
  372.      b) Use the OS/2 boot menu (hit ALT-F1 when the white brick
  373.      appears during a reboot), reset to VGA mode, reboot, and
  374.      reinstall your drivers using selective install or your card
  375.      manufacturer install program.
  376.  
  377.   Then,
  378.  
  379.   If you used the automatic patch facility in step 7, and it doesn't seem
  380.   to have worked, then try making the patches using the patch locator (use
  381.   old-<dllname.dll> or <dllname>.old from now on when prompted for the
  382.   DLL to patch).
  383.  
  384.   If you used the patch locator, then try using different patch
  385.   options.  The asterisked choices will work for the majority of
  386.   drivers, but there will inevitably be some exceptions.
  387.  
  388.   Try getting the icons working first.  Then try the fonts, then DPI.
  389.   From user feedback so far, the most common cause of a crash or hang
  390.   is getting the 1280x1024 font patch wrong.  The others patches cause
  391.   massive icons, or strange text when they go wrong.
  392.  
  393.   If you have absolutely no luck at all, then send me email.  The
  394.   chances are that someone else has had the same problems and notified
  395.   me of a solution.
  396.  
  397. 5. Refresh rates and resolutions
  398.  
  399.    Fixdisp does not even attempt to solve any problems you might have
  400.    obtaining resolutions of 1024x768 and above.
  401.  
  402. 6. My Windows(tm) sessions have horrible big window capion bars, fonts, and
  403.    icons!
  404.  
  405.    Fixdisp does not patch Windows(tm) drivers.  I do not know of any
  406.    patch programs similar to fixdisp which will.  Complain to IBM! :-)
  407.  
  408.  
  409.  
  410. The source code
  411. ---------------
  412.  
  413. The source code for fixdisp is no longer included within this archive.
  414. The latest version has some rather embarassingly horrible code in it,
  415. so it's now available on request only! :-)
  416.  
  417.  
  418. Distribution
  419. ------------
  420.  
  421. Feel free to distribute this archive (unmodified) far and wide.  It should 
  422. always be available from ftp-os2.nmsu.edu in /os2/warp/patches/smallf??.zip.
  423.  
  424.  
  425. Licence
  426. -------
  427.  
  428. smallfix is absolutely free.  Users incur no obligation to the authors
  429. as a result of using it.  Please read the disclaimer at the bottom of
  430. this file though.
  431.  
  432.  
  433. Acknowledgements
  434. ----------------
  435.  
  436. Daniel J Neades (djn@arac.demon.co.uk), for the information about
  437. which bits of the display drivers need twiddling.
  438.  
  439. Guido Jaekel (Guido.Jaekel@Physik.Uni-Osnabrueck.DE), for various things.
  440.  
  441. Thanks to *everyone* who's sent me email about previous versions of
  442. smallfix.
  443.  
  444. The ever-incompetent IBM for the large fonts and icons.
  445.  
  446.  
  447. DISCLAIMER  (very important)
  448. ----------------------------
  449.  
  450.  The authors accept absolutely NO responsiblity for any adverse
  451.  consequences arising from the use or misuse of this program. IBM will
  452.  probably not provide any form of support for modified display
  453.  drivers.
  454.  
  455.  Modifying display drivers is a messy business.  If you are not 100%
  456.  confident in your display driver twiddling abilities then DO NOT USE
  457.  THIS SOFTWARE.  You have been warned.
  458.  
  459.  This software has nothing to do with IBM.  Do not contact IBM if you
  460.  have problems with this software.
  461.  
  462.  
  463. Enjoy,
  464.  
  465. Jason R. Shannon (jrs@larch.demon.co.uk)
  466. 21st February 1994
  467.  
  468.  
  469.  
  470.