From nobody@FreeBSD.org  Wed Oct 14 14:54:02 2009
Return-Path: <nobody@FreeBSD.org>
Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34])
	by hub.freebsd.org (Postfix) with ESMTP id 313EE1065679
	for <freebsd-gnats-submit@FreeBSD.org>; Wed, 14 Oct 2009 14:54:02 +0000 (UTC)
	(envelope-from nobody@FreeBSD.org)
Received: from www.freebsd.org (www.freebsd.org [IPv6:2001:4f8:fff6::21])
	by mx1.freebsd.org (Postfix) with ESMTP id 200E68FC16
	for <freebsd-gnats-submit@FreeBSD.org>; Wed, 14 Oct 2009 14:54:02 +0000 (UTC)
Received: from www.freebsd.org (localhost [127.0.0.1])
	by www.freebsd.org (8.14.3/8.14.3) with ESMTP id n9EEs1KS026442
	for <freebsd-gnats-submit@FreeBSD.org>; Wed, 14 Oct 2009 14:54:01 GMT
	(envelope-from nobody@www.freebsd.org)
Received: (from nobody@localhost)
	by www.freebsd.org (8.14.3/8.14.3/Submit) id n9EEs16C026441;
	Wed, 14 Oct 2009 14:54:01 GMT
	(envelope-from nobody)
Message-Id: <200910141454.n9EEs16C026441@www.freebsd.org>
Date: Wed, 14 Oct 2009 14:54:01 GMT
From: Norbert Papke <npapke@acm.org>
To: freebsd-gnats-submit@FreeBSD.org
Subject: Clarify subpixel smoothing for fonts in Handbook
X-Send-Pr-Version: www-3.1
X-GNATS-Notify:

>Number:         139603
>Category:       docs
>Synopsis:       [patch] Clarify subpixel smoothing for fonts in Handbook
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    pav
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Wed Oct 14 15:00:08 UTC 2009
>Closed-Date:    Mon Dec 14 17:11:43 UTC 2009
>Last-Modified:  Mon Dec 14 17:11:43 UTC 2009
>Originator:     Norbert Papke
>Release:        7.2-STABLE
>Organization:
>Environment:
>Description:
In section 5.5.3, the handbook explains how to improve the quality of fonts on 
LCD monitors by enabling subpixel smoothing.  However, the section does not 
draw attention to the fact that the print/freetype2 port must be compiled with 
non-default options to allow this.

I am unsure whether the port makefile's patent warning should be mentioned.

>How-To-Repeat:

>Fix:


Patch attached with submission follows:

--- en_US.ISO8859-1/books/handbook/x11/chapter.sgml	2 Oct 2009 08:32:07 -0000	1.195
+++ en_US.ISO8859-1/books/handbook/x11/chapter.sgml	14 Oct 2009 14:51:49 -0000
@@ -1078,8 +1078,17 @@
        <para>One last point: with an LCD screen, sub-pixel sampling may be
         desired.  This basically treats the (horizontally separated)
         red, green and blue components separately to improve the horizontal
-        resolution; the results can be dramatic.  To enable this, add the
-        line somewhere in the <filename>local.conf</filename> file:</para>
+        resolution; the results can be dramatic.  To enable this, compile the
+        <filename role="package">print/freetype2</filename> port with
+        LCD filtering enabled.</para>
+
+        <screen>
+        &prompt.root; <userinput>cd /usr/ports/print/freetype2</userinput>
+        &prompt.root; <userinput>make -DWITH_LCD_FILTERING clean install</userinput>
+        </screen>
+
+       <para>Then add the following lines to the <filename>local.conf</filename>
+       file:</para>
 
        <programlisting>
          &lt;match target="font"&gt;


>Release-Note:
>Audit-Trail:
State-Changed-From-To: open->feedback 
State-Changed-By: pav 
State-Changed-When: Mon Dec 14 14:45:44 UTC 2009 
State-Changed-Why:  
Are you sure? I have subpixel rendering within GNOME even without the freetype 
option you're refering to. IIRC that option just toggles on different method of 
doing the rendering. 


Responsible-Changed-From-To: freebsd-doc->pav 
Responsible-Changed-By: pav 
Responsible-Changed-When: Mon Dec 14 14:45:44 UTC 2009 
Responsible-Changed-Why:  
Are you sure? I have subpixel rendering within GNOME even without the freetype 
option you're refering to. IIRC that option just toggles on different method of 
doing the rendering. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=139603 
State-Changed-From-To: feedback->closed 
State-Changed-By: pav 
State-Changed-When: Mon Dec 14 17:11:31 UTC 2009 
State-Changed-Why:  
Not important enough to be includeed in Handbook, IMHO 

http://www.freebsd.org/cgi/query-pr.cgi?pr=139603 
>Unformatted:
