Wix/pango.README

   1 Pango is a library for layout and rendering of text, with an emphasis
   2 on internationalization. Pango can be used anywhere that text layout
   3 is needed; however, most of the work on Pango so far has been done using
   4 the GTK+ widget toolkit as a test platform. Pango forms the core of text
   5 and font handling for GTK+-2.x.
   6
   7 Pango is designed to be modular; the core Pango layout can be used
   8 with three different font backends:
   9
  10  - Client-side fonts on X using the Xft library
  11  - Direct rendering of scalable fonts using the FreeType library
  12  - Native fonts on Microsoft backends
  13
  14 (There is also a core-X font backend still present in the code;
  15 usage of this backend is deprecated)
  16
  17 Dynamically loaded modules then handle text layout for particular
  18 combinations of script and font backend.
  19
  20 As well as the low level layout rendering routines, Pango includes
  21 PangoLayout, a high level driver for laying out entire blocks of text,
  22 and routines to assist in editing internationalized text.
  23
  24 For more information about Pango, see:
  25
  26  http://www.pango.org
  27
  28 Dependencies
  29 ============
  30
  31 Pango depends on version 2.4.0 or new of the GLib library; more
  32 information about GLib can be found at http://www.gtk.org/.
  33
  34 The supported font backend for X in Pango-1.4 is the Xft backend
  35 which uses version 2 of the Xft library to manage client
  36 side fonts. Version 2 of Xft is available from http://fontconfig.org/
  37 Along with Xft, you'll need to install its dependency fontconfig, and
  38 possibly also the Xrender library, if that doesn't come with
  39 your system. Both of these libraries are available from
  40 the same place as fontconfig.
  41
  42 Note that an earlier version of Xft is shipped with version
  43 of XFree86 up to 4.2. This version does not work with Pango-1.4;
  44 Pango-1.4 requires version 2 of Xft, which is present in XFree86-4.3
  45 and newer and in X11R6.7 and X11R6.8.
  46
  47 Both Xft and the optional PangoFT2 backend require the fontconfig
  48 library (http://www.fontconfig.org) to look up fonts. At least version
  49 2.0.9 of the FreeType font handling library (http://www.freetype.org)
  50 is also required. If fontconfig and FreeType are not found at
  51 configure time, or FreeType is too old, then neither the Xft nor the
  52 FT2 backend is will be built.
  53
  54 After installing fontconfig, it may be necessary to edit
  55 the fonts.conf file, found at $(sysconfdir)/fonts/fonts.conf
  56 (usually /etc/fonts/fonts.conf) to point at the fonts
  57 on your system.
  58
  59 Installation of Pango on Win32 is possible, but is not documented
  60 here. See http://www.gimp.org/~tml/win32/downloads.html.
  61
  62 Notes
  63 =====
  64
  65  - By default, Pango tries to build itself so that no explicit
  66    dependency on Xft or FreeType will be introduced in apps that
  67    link to Pango. This is to avoid compatibility problems with
  68    changes in the Xft or FreeType API's or ABI's. Specifying
  69    --enable-explicit-deps or --enable-static when configuring Pango
  70    will defeat this and should be avoided if possible.
  71
  72 License
  73 =======
  74
  75 Most of the code of Pango is licensed under the terms of the
  76 GNU Lesser Public License (LGPL) - see the file COPYING for details.
  77
  78 The OpenType code in pango/opentype is derived from the FreeType
  79 project (http://www.freetype.org) and is dual-licensed under the
  80 GNU Public License and the FreeType license. See see
  81 pango/opentype/FT-license.txt for full details of the FreeType
  82 license.
  83
  84 Note that binary distributions of Pango must include a disclaimer
  85 that the software is based in part of the work of the FreeType Team,
  86 in the distribution documentation; for instance, by including this
  87 README file.
  88
  89 Owen Taylor
  90 otaylor@redhat.com
  91 13 September 2004