From rsidd@lpt.ens.fr  Tue Sep  4 08:55:40 2001
Return-Path: <rsidd@lpt.ens.fr>
Received: from postfix1-2.free.fr (postfix1-2.free.fr [213.228.0.130])
	by hub.freebsd.org (Postfix) with ESMTP id 4560037B40C
	for <FreeBSD-gnats-submit@freebsd.org>; Tue,  4 Sep 2001 08:55:40 -0700 (PDT)
Received: from bluerondo.a.la.turk (nas-cbv-2-28-223.dial.proxad.net [213.228.28.223])
	by postfix1-2.free.fr (Postfix) with ESMTP id AEB1BAB1C4
	for <FreeBSD-gnats-submit@freebsd.org>; Tue,  4 Sep 2001 17:55:36 +0200 (CEST)
Received: (qmail 6433 invoked by uid 1001); 4 Sep 2001 15:54:39 -0000
Message-Id: <20010904155439.6432.qmail@bluerondo.a.la.turk>
Date: 4 Sep 2001 15:54:39 -0000
From: Rahul Siddharthan <rsidd@physics.iisc.ernet.in>
Reply-To: Rahul Siddharthan <rsidd@physics.iisc.ernet.in>
To: FreeBSD-gnats-submit@freebsd.org
Cc:
Subject: Handbook section on antialiased fonts with gtk/gnome
X-Send-Pr-Version: 3.113
X-GNATS-Notify:

>Number:         30316
>Category:       docs
>Synopsis:       Handbook section on antialiased fonts with gtk/gnome
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          update
>Submitter-Id:   current-users
>Arrival-Date:   Tue Sep 04 09:00:05 PDT 2001
>Closed-Date:    Sun Sep 16 20:47:02 PDT 2001
>Last-Modified:  Sun Sep 16 20:47:37 PDT 2001
>Originator:     Rahul Siddharthan
>Release:        FreeBSD 4.4-PRERELEASE i386
>Organization:
>Environment:
System: FreeBSD bluerondo.a.la.turk 4.4-PRERELEASE FreeBSD 4.4-PRERELEASE #14: Mon Aug 27 08:39:23 CEST 2001 root@bluerondo.a.la.turk:/usr2/src/sys/compile/BLUERONDO i386


	
>Description:
   A small addition to the section on GNOME, on how to enable
antialiased fonts there.
>How-To-Repeat:

>Fix:

--- chapter.sgml	Tue Sep  4 17:45:46 2001
+++ chapter.sgml	Tue Sep  4 17:50:42 2001
@@ -755,9 +755,12 @@
 	can use anti-aliased fonts
         (see <xref linkend="x11-wm-kde2-antialias"> on 
 	<application>KDE</application> for
-        details); there are patches for gtk+ to do the same,
+        details); there are patches for gtk+ to do the same, 
         so if compiled against such a patched gtk+, the GNOME environment
-        and Mozilla can also use anti-aliased fonts.</para>
+        and Mozilla can also use anti-aliased fonts.  In fact, there
+        is now a library called gdkxft (in the ports) which allows one
+	to use antialiased fonts without recompiling: see 
+	<xref linkend="x11-wm-gnome-antialias"> for details.</para>
 
        <para>Anti-aliasing is still new to FreeBSD and 
 	<application>XFree86</application>;
@@ -1109,6 +1112,45 @@
           <link linkend="x11-wm-kde2-details">KDE2 details</link>
           explains how to do this for <filename>kdm</filename>, the
           display manager of <application>KDE</application>.</para>
+      </sect3>
+      <sect3 id="x11-wm-gnome-antialias">
+        <title>Anti-aliased fonts with GNOME</title>
+
+	<para>While anti-aliased fonts made their first appearance 
+	on XFree86 desktops in the KDE environment and are supported
+	there in the standard installation, it is possible to use them
+	with gtk applications such as the GNOME environment too.  The
+	most straightforward way is probably by using the recent library
+	<application>libgdkxft</application>, in the ports (x11/gdkxft).
+	After installing this port, read carefully the file 
+	<filename>/usr/X11R6/share/doc/gdkxft/README</filename>.</para>
+
+	<para>If you already have a working
+	<filename>XftConfig</filename> file, all you really need to do is
+	tell your gtk applications to look for their font-rendering
+	functions in <filename>libgdkxft.so</filename> before looking in the
+	standard place, <filename>libgdk.so</filename>.  This is easily
+	accomplished by setting an environment variable to point to the
+	right place; with the Bourne shell
+	(<application>/bin/sh</application>) or similar shells, type
+	the command (to start the Gimp, say)</para>
+<screen>&prompt.user; <userinput>LD_PRELOAD=/usr/X11R6/lib/libgdkxft.so gimp</userinput></screen>
+	<para>and with csh and similar shells, type</para>
+<screen>
+&prompt.user; <userinput>setenv LD_PRELOAD /usr/X11R6/lib/libgdkxft.so</userinput> 
+&prompt.user; <userinput>gimp</userinput>
+</screen>
+	<para>It is a nuisance to do this all the time, so you can
+simply put the commands</para>
+<programlisting>
+LD_PRELOAD=/usr/X11R6/lib/libgdkxft.so
+export LD_PRELOAD
+</programlisting>
+	<para>into your <filename>.xinitrc</filename>,
+	<filename>.xsession</filename> or in the appropriate place(s) in
+	<filename>/usr/X11R6/lib/X11/xdm/Xsession</filename>, depending
+	on how you normally start X.  However, this short-cut may cause
+	you problems if you want to run linux gtk binaries.</para>
       </sect3>
     </sect2>
 
>Release-Note:
>Audit-Trail:
State-Changed-From-To: open->closed 
State-Changed-By: murray 
State-Changed-When: Sun Sep 16 20:47:02 PDT 2001 
State-Changed-Why:  
Your addition has been committed with minor changes.  It may take up 
to 24 hours for this change to reach the web site.  Thanks for your 
submission! 


http://www.FreeBSD.org/cgi/query-pr.cgi?pr=30316 
>Unformatted:
