   Dependent lib for Mozilla Cairo builds
  ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

- Setting it up
To make use of this package for compilation of a Mozilla build that makes use
of the cairo library, you need a GCC, and various other libraries and
environment variables set. Please follow the guide at
   http://developer.mozilla.org/en/docs/OS/2_Build_Prerequisites
how to do this.

Move the whole directory containing this package where you want it installed
and then run
   make -s
   make clean
This compiles all files, collects the object files into mzfntcfg.lib and mozft.lib
and adapts the installation to your directory tree. Then it removes the unnecessary
object files.
(If for whatever reason you want to recompile everything, do
   make -s nuke all
   make clean
This comes in handy on GCC upgrades.)

Now be sure to also adapt the MZFNTCFGFT variable in your setmozenv.cmd, so
that this package can be used by the Mozilla build process. In case your
setmozenv.cmd does _not_ yet contain these variables add the
following lines:
  'set MZFTCFGFT=%ROOT%\mzfntcfgft'
  'set MZFTCFGFT2='backtoforward(value('MZFTCFGFT',,'OS2ENVIRONMENT'));


- Sources
The required source code is contained in this package. It is compiled from bits
of the packages
   fontconfig           (the Netlabs version by ErOs2 and Doodle, enhanced by
                        me in collaboration with Doodle)
   fontconfig-2.3.2-os2 (only the header files of the original Fontconfig package)
Both are part of the *dependencies* packages on <ftp://ftp.netlabs.org/pub/Cairo/>.
   ft235.zip            (from http://sourceforge.net/project/showfiles.php?group_id=3157&package_id=3121)
Differences from the default configuration of FreeType (in the header files in
include\freetype\config are marked with PmW.


- Using the library
If you built a Mozilla application with SVG support or if you compile a current
trunk build, the above configuration will automatically link this library
statically into one of the DLLs or the static EXE (depending on the build
configuration).


- Copyright
See mzfntcfg.COPYING for copyright information. That file contains the required
copyright notes from both base packages.
(If you want to ship a program linked against this library, you should not
forget to package mzfntcfg.COPYING, too, unless you built the program from
current Mozilla trunk, which already has the necessary info in about:license.)


- History
20080315  - Compile FT stroking code, too
          - Implement FcPatternEqual()
20080307  Lots of improvements to the FontConfig port with help from Doodle
          - Improve matching of installed fonts (exact font name matched first)
          - Add support for oblique fonts
          - More FontConfig properties supported (hint style, RGBA, style, etc.)
          - Add function FcFreeTypeQuery()
          - Support multiple font faces in one font file
          . Because of the latter, has to cache fonts in a new OS2.INI key
            (PM_Fonts_FontConfig_Cache_v1.1)
20071125  - Upgrade to FT 2.3.5
          - Add a few features and fix a few bugs of the OS/2 Fontconfig
            implementation
20070528  - Change from DLL and DLL import library to static import library
          + Fix a small mistake when returning the matched font name
20070518  - Upgrade to FT 2.3.4 and switch from standard FC to Netlabs
            version


- Contact person
If you want to complain please post to the group mozilla.dev.ports.os2 on the
newsserver news.mozilla.org.

Peter Weilbacher <mozilla@Weilbacher.org>, 15Mar2008
