GdkXft for Debian
-----------------

*** THIS THING WILL CAUSE SOME GTK APPLICATIONS TO FREAK OUT ***
*** THIS THING WILL CAUSE FONTS IN SOME GTK APPS TO BE UNREADABLE ***
*** THIS THING MIGHT EVEN CRASH YOUR X SERVER IF IT GETS CONFUSED ***

The libgdkxft0 package provides a backend for antialiasing fonts in GTK+ 1.2
applications. To actually activate antialiasing, you need to configure:

  * the fonts that should be antialiased. This is done by editing
    in /etc/gtk/gdkxft.conf or ~/.gdkxft as described in the README.gz
    file, see the section "Configuring gdkxft at run-time".
    The generic Xft font configuration file is /etc/X11/XftConfig, you
    might want to edit that one, too.  I've included the gdkxft_sysinstall
    script in the documentation directory as an example application
    that is able to set up an Xft configuration.  This was included
    because a user has found it useful for his configuration.
  * the pre-loading of the GdkXft library. If you use gdm, select the
    Gnome-AA session and the library will be preloaded automatically.
    If you don't use gdm, set the LD_PRELOAD environment variable to
    /usr/lib/libgdkxft.so
    Some applications may require other settings to be tuned in order
    to activate GdkXft antialiasing, for example you need to set
    USE_GDKXFT=true for mozilla to use antialiased fonts. See the other
    packages' documentation for details.

The README.gz file in this directory for installation instructions,
but you should skip the parts about installing from source, running
gdkxft_sysinstall, and copying the theme file to .gtkrc, because they
won't work properly on Debian. The package files have already been
installed properly, gdkxft_sysinstall is not necessary and doesn't exist,
and the theme file can be activated with putting this line in your ~/.gtkrc:

include "/usr/share/themes/Gdkxft/gtk/gtkrc"

[Thanks to Josip Rodin for writing this]