svn commit: r49376 - head/en_US.ISO8859-1/books/handbook/x11

[Warren Block]

Author: wblock
Date: Fri Sep  9 15:33:51 2016
New Revision: 49376
URL: https://svnweb.freebsd.org/changeset/doc/49376

Log:
  Update anti-aliased fonts section. Patch supplied by Tim Moore
  <timmoore88_gmail.com>, based on bug report by Brandon S Allbery
  <allbery.b at gmail.com>.  Other edits added to fix wording in old section
  and correct indentation in programlisting elements (content, in this
  case).
  
  PR:		193612
  Submitted by:	Brandon S Allbery <allbery.b at gmail.com>
  Sponsored by:	iXsystems
  Differential Revision:	https://reviews.freebsd.org/D7841

Modified:
  head/en_US.ISO8859-1/books/handbook/x11/chapter.xml

Modified: head/en_US.ISO8859-1/books/handbook/x11/chapter.xml
==============================================================================
--- head/en_US.ISO8859-1/books/handbook/x11/chapter.xml	Fri Sep  9 14:18:36 2016	(r49375)
+++ head/en_US.ISO8859-1/books/handbook/x11/chapter.xml	Fri Sep  9 15:33:51 2016	(r49376)
@@ -1054,7 +1054,7 @@ EndSection</programlisting>
 	<application>GNOME</application>, and
 	<application>Firefox</application>.</para>
 
-      <para>In order to control which fonts are anti-aliased, or to
+      <para>To control which fonts are anti-aliased, or to
 	configure anti-aliasing properties, create (or edit, if it
 	already exists) the file
 	<filename>/usr/local/etc/fonts/local.conf</filename>.  Several
@@ -1078,15 +1078,15 @@ EndSection</programlisting>
       <para>As previously stated, all fonts in
 	<filename>/usr/local/share/fonts/</filename> as well as
 	<filename>~/.fonts/</filename> are already made available to
-	Xft-aware applications.  If you wish to add another directory
-	outside of these two directory trees, add a line similar to
-	the following to
+	Xft-aware applications.  To add another directory
+	outside of these two directory trees, add a line like
+	this to
 	<filename>/usr/local/etc/fonts/local.conf</filename>:</para>
 
       <programlisting><dir>/path/to/my/fonts</dir></programlisting>
 
       <para>After adding new fonts, and especially new font
-	directories, you should run the following command to rebuild
+	directories, rebuild
 	the font caches:</para>
 
       <screen>&prompt.root; <userinput>fc-cache -f</userinput></screen>
@@ -1120,13 +1120,13 @@ EndSection</programlisting>
 	<secondary>spacing</secondary>
       </indexterm>
 
-      <para>Spacing for some monospaced fonts may also be
+      <para>Spacing for some monospaced fonts might also be
 	inappropriate with anti-aliasing.  This seems to be an issue
 	with <application>KDE</application>, in particular.  One
-	possible fix for this is to force the spacing for such fonts
-	to be 100. Add the following lines:</para>
+	possible fix is to force the spacing for such fonts
+	to be 100. Add these lines:</para>
 
-      <programlisting>       <match target="pattern" name="family">
+      <programlisting>	<match target="pattern" name="family">
 	   <test qual="any" name="family">
 	       <string>fixed</string>
 	   </test>
@@ -1170,16 +1170,15 @@ EndSection</programlisting>
 	     </edit>
 	 </match>        </programlisting>
 
-      <para>Once you have finished editing
-	<filename>local.conf</filename> make sure you end the file
+      <para>After editing
+	<filename>local.conf</filename>, make certain to end the file
 	with the <literal></fontconfig></literal> tag.  Not
-	doing this will cause your changes to be ignored.</para>
+	doing this will cause changes to be ignored.</para>
 
-      <para>Finally, users can add their own settings via their
-	personal <filename>.fonts.conf</filename> files.  To do this,
-	each user should simply create a
-	<filename>~/.fonts.conf</filename>.  This file must also be in
-	XML format.</para>
+      <para>Users can add personalized settings by creating their own
+	<filename>~/.config/fontconfig/fonts.conf</filename>.  This
+	file uses the same <acronym>XML</acronym> format described
+	above.</para>
 
       <indexterm><primary>LCD screen</primary></indexterm>
       <indexterm><primary>Fonts</primary>
@@ -1192,7 +1191,7 @@ EndSection</programlisting>
 	dramatic.  To enable this, add the line somewhere in
 	<filename>local.conf</filename>:</para>
 
-      <programlisting><match target="font">
+      <programlisting>	 <match target="font">
 	     <test qual="all" name="rgba">
 		 <const>unknown</const>
 	     </test>