************************************************************
* README FILE FOR FontFolder V1.2 * 
************************************************************

FILES FOR FONTFOLDER VERSION 1.2

  DISKETTE VERSION
  
  The diskette for FontFolder Version 1.2 should contain the 
  following files:
  
    FONTFOLD.EXE   FontFolder program file
    FONTFOLD.HLP   FontFolder Help file
    FONTFOLD.NEW   Brief description of new and changed
                   features of Version 1.2
    LICENSE.TXT    FontFolder License file
    README.TXT     This file
  
  In addition, the diskette should also contain the files
  shown next for the ON-LINE VERSION of FontFolder.  Note
  that these are all ZIP files.
  
  ON-LINE VERSION
  
  On-line users should look for the following files, all of
  which are in ZIP format.  FNTF12.ZIP is required, all of
  the rest are optional add-on packages for FontFolder V12.
  
    FNTF12.ZIP     Contains the five files named above. 
                   Please use this file if you upload
                   FontFolder to a bulletin board or on-line
                   service.
    FF12IN.ZIP     FontFolder Help file in INF format for 
                   viewing with OS/2's VIEW.EXE
    BITST500.FZ2   Pre-registered library for the Bitstream 
                   500 Font CDROM (includes library and text
                   documentation file).
    COREL25.FZ2    Pre-registered library for the fonts on 
                   the CorelDraw 2.5 for OS/2 CDROM.
                   (includes library and text documentation
                   file).
    HOBB1093.FZ2   Pre-registered library for the fonts on 
                   the October, 1993 Hobbes OS/2 CDROM.
                   (includes library and text documentation
                   file).


GENERAL 

This README file gives basic information for installing and 
starting FontFolder for the first time.  For more detailed 
instructions on starting and using FontFolder, consult the 
on-line Help.  

INSTALLATION INSTRUCTIONS:  

NEW FONTFOLDER USERS

Copy the FONTFOLD.EXE and FONTFOLD.HLP files to any 
directory. When you start FontFolder the first time it will 
ask you to make some choices of directory locations for its 
files, and ask you to confirm the drive letters it has 
determined for your removable drives and for your CDROM 
drives if you have any. This information will be saved so 
you will not have to repeat this in the future when you 
start FontFolder.

After starting FontFolder for the first time, bring up the 
Help and read the sections on FontFolder Overview, 
Installing FontFolder and Using FontFolder for basic 
familiarization with the program.  Help is also available 
for all menu items; hit F1 when the menu item is selected.  

The On-line Help is also available in INF format as a 
separate file, FF12HELP.INF.  On Compuserve, look for 
FF12IN.ZIP in OS2BVEN, Lib 1. 


USERS UPGRADING FROM AN EARLIER VERSION OF FONTFOLDER

Copy the FONTFOLD.EXE and FONTFOLD.HLP files to any 
directory, but do not put them in the same directory as your 
previous version FontFolder files unless you intend to 
overwrite the previous version, as the filenames are the 
same.  If you install version 1.2 in a different directory 
and already have created a Master Library, FontPacks and 
customized settings with a previous version of FontFolder, 
copy over the MASTLIB.DAT file, all FNTPKnnn.FP1 files, and 
the FONTFOLD.INI file from your old FontFolder directory.  

Version 1.2 uses a new format for data files, so the first 
time you start version 1.2 it will look for old format data 
files to convert. If you have installed version 1.2 in the 
same directory as your previous version of FontFolder, 
FontFolder will backup your present data files before 
converting them to the new format. The backup files will 
have the extension OLD. The conversion is a one-time 
process. When you start FontFolder in the future it will use
the new data files.

If you installed version 1.2 in its own directory and copied 
over the previous version's data and ini files, you need to 
pay special attention to the messages that FontFolder 
displays the first time you start version 1.2.  FontFolder 
will detect that the ini file has been moved from its 
previous directory and alert you to that fact.  It will warn 
you to examine the settings in the next dialog carefully and 
make the appropriate changes.  It will then display a dialog 
containing key settings from your old version and give you 
the opportunity to update them.  PAY PARTICULAR ATTENTION to 
the Path to FontFolder Data Files setting as it will still 
be set to the old location of your data files.  You MUST 
change this if you moved your data files to the version 1.2 
directory.  If you do not change this setting, FontFolder 
will convert the data files in the old directory location 
and use those data files instead of the ones that you moved 
to the 1.2 directory.  Also note in this dialog that if you 
have a CDROM drive, it will still be listed as a removable 
drive as it was in your previous version of FontFolder.  If 
you want to take advantage of the version 1.2 capability to 
use fonts directly from a CDROM drive without you having to 
copy them to your hard drive, you should make the 
appropriate changes to your drive letter settings at this 
time. Once you have made your changes to this dialog, click 
on OK, and FontFolder will proceed to convert your data 
files as described above.

If you stored the FONTFOLD.INI file in a directory different 
from the one containing FONTFOLD.EXE in your previous 
version, you can do a similar thing for version 1.2.  If you 
want to maintain a working copy of your old version while 
testing version 1.2, use a different directory to keep the 
FONTFOLD.INI files separate.  The two versions use different 
entries in OS2.INI, so they will not conflict.  

Read the FONTFOLD.NEW file for an overview of the new 
features available in Version 1.2.  More detailed 
information on the features is available in the on-line 
Help.  This Help is also available in INF format as a 
separate file, FF12HELP.INF.  On Compuserve, look for 
FF12IN.ZIP in OS2BVEN, Lib 1. 


PROBLEMS ON FONTFOLDER STARTUP:  

When you start FontFolder the first time you may find that 
it complains about a number of fonts that you have already 
"installed" in OS/2 through the OS/2 Font Pallete.  This can 
be for a number of reasons outlined below, all of which 
represent legitimate problems that FontFolder is attempting 
to deal with.  (Of course it may also be true that 
FontFolder is incorrectly objecting to a legitimately 
installed font.  If that appears to be the case, please 
bring the situation to my attention via one of the routes 
described at the end of this ReadMe file.)  

Situations where FontFolder will object to an already 
"installed" font:  

1. The OS/2 Font Pallete is unfortunately not too 
discriminating in what it will "install" in OS/2.  There are 
examples of font AFM files that are totally unreadable 
because of garbage in the file.  The Font Pallete will 
"install" these files, although they are unusable and show 
up in the Font Pallete list as blank lines.  FontFolder will 
reject a file if the OS/2 api that is used to query font 
information can't at least return a name for the font (the 
blank line in the Font Pallete occurs because no font name 
was returned for the file).  

2. Users have been known to install a font in OS/2 and then 
later move the OFM and PFB files for this font to a 
different directory or even erase them, without first 
un-installing the font from OS/2.  However, OS/2 keeps a 
record in OS2.INI of where it thinks the files are for 
installed fonts, and when it can't find them there on 
bootup, things get quite confusing.  The user finds that a 
previously installed font "no longer works", but when they 
try to re-install it they find they can't because OS/2 
insists it is already installed.  FontFolder checks the 
listings in OS2.INI and verifies that both a PFB file and an 
OFM file exist where OS2.INI claims they are located.  

In both of the above cases, FontFolder a) does not show the 
font in the installed fonts list, and b) puts up a message 
box alerting the user to the problem and offering to remove 
the entry for this font from OS2.INI.  You should note what 
font files FontFolder can't find, and then accept the offer 
to clean up OS2.INI.  If the problem is simply that the font 
files have been moved, you can then go and find out where 
the font files are currently located (if they still exist) 
and register the fonts with the Library from the correct 
location.  


KNOWN PROBLEMS/LIMITATIONS:  

1. There are "bad fonts" out there.  A "bad font" is defined 
here as any font that either won't install in OS/2, or when 
installed won't display or even worse sends the system in to 
some sort of never-never land.  My experience with the 400+ 
fonts I have is about 1-2% fall in to this "bad font"
category.  This does not necessarily mean that something is 
wrong with the font, just that the font and OS/2 do not get 
along.  In my experience, "bad fonts" are almost always 
caused by a bug in OS/2's PMATM.DLL that occurs with certain 
"complex" fonts, rather than as a result of anything being 
wrong with the font files themselves.  FontFolder screens 
out some but not all "bad fonts" that the OS/2 Font Pallete 
lets pass.  

Viewing these "bad fonts" in the Font Information window can 
cause a variety of things to happen, from the harmless case 
of nothing appearing in the sample window, to a SYS 3175 
error, to a total lockup of the machine that requires a 
reboot.  I so far have found no way to protect against the 
total lockup.  Needless to say, if a font causes this to 
happen, remove it from the Library.  

2. OS/2 does not allow FontFolder to remove any font from 
memory that was not installed by FontFolder in the current 
session.  FontFolder always updates the OS2.INI file and 
shows the font as removed, but if you check the Font Palette 
or look in the font list presented by your application, you 
will see that the font is still there.  It will be gone the 
next time you reboot.  

This is not a problem if you don't change fonts frequently 
since any font removed by FontFolder will be gone the next 
time you reboot.  However, if you work with large numbers of 
fonts during a single session, you may end of with very 
large numbers of fonts installed in OS/2, with performance 
and even perhaps error problems.  The way to avoid this is 
to only keep a minimum number of fonts, the ones you use 
all the time, loaded in OS/2 at startup.  Then start 
FontFolder and keep it open during the entire session if 
you are going to work with large numbers (100's) of fonts 
during the session.  FontFolder can be minimized when you 
are not using it, but don't close it.  This way, FontFolder 
can completely remove any font it installed (as long as you 
aren't currently using the font in an open application).  
Before closing FontFolder, clean up your installed font list 
by removing all the fonts other than your basic font set.  
(HINT:  Define a FontPack to be your basic set of fonts.  
Then just before closing FontFolder, remove everything extra 
and install this FontPack.  That will guarantee that you 
always have the correct base set installed on bootup).  

3. It is easy to browse large numbers of fonts in the Font 
Information window with version 1.2 of FontFolder.  This can 
quickly consume large amounts of memory, causing problems if 
you are short of swap file space.  Look in the online Help 
Index for "browsing fonts" and read this section to 
understand what the memory requirements are when browsing 
fonts.  

********************************************************************* 

FONTFOLDER SUPPORT:  

Support for FontFolder is provided on Compuserve in OS2BVEN, 
Section 1 (GO OS2SHARE).  Latest versions of FontFolder will 
also be posted to the library there and will have a filename of
FNTFnn.ZIP where nn is the version number.  Or send e-mail to to 
me at [75013,1701] on Compuserve or via the Internet to
75013.1701@compuserve.com.  

Cliff Cullum 
