From 5359736db7a527d466adad23e8086c716960944e Mon Sep 17 00:00:00 2001
From: Sevan Janiyan <sevan@FreeBSD.org>
Date: Sun, 15 Jan 2017 02:53:10 +0000
Subject: [PATCH] Direct reader to install packages first.

Approved by:	bcr (mentor)
Differential Revision:	https://reviews.freebsd.org/D9173
---
 .../books/handbook/x11/chapter.xml            | 23 +++++++++++--------
 1 file changed, 14 insertions(+), 9 deletions(-)

diff --git a/en_US.ISO8859-1/books/handbook/x11/chapter.xml b/en_US.ISO8859-1/books/handbook/x11/chapter.xml
index a6089c68c2..dca73e6550 100644
--- a/en_US.ISO8859-1/books/handbook/x11/chapter.xml
+++ b/en_US.ISO8859-1/books/handbook/x11/chapter.xml
@@ -240,19 +240,19 @@
     <para>On &os;, <application>&xorg;</application> can be installed
       as a package or port.</para>
 
+    <para>The binary package can be installed quickly but with
+      fewer options for customization:</para>
+
+    <screen>&prompt.root; <userinput>pkg install xorg</userinput></screen>
+
     <para>To build and install from the Ports Collection:</para>
 
     <screen>&prompt.root; <userinput>cd /usr/ports/x11/xorg</userinput>
 &prompt.root; <userinput>make install clean</userinput></screen>
 
-    <para>The binary package can be installed more quickly but with
-      fewer options for customization:</para>
-
-    <screen>&prompt.root; <userinput>pkg install xorg</userinput></screen>
-
     <para>Either of these installations results in the complete
-      <application>&xorg;</application> system being installed.  This
-      is the best option for most users.</para>
+      <application>&xorg;</application> system being installed.  Binary packages
+      are the best option for most users.</para>
 
     <para>A smaller version of the X system suitable for experienced
       users is available in <package>x11/xorg-minimal</package>.  Most
@@ -931,8 +931,13 @@ EndSection</programlisting>
 	on this, see the &man.X.7; manual page or <xref
 	  linkend="truetype"/>.</para>
 
-      <para>To install the above Type1 font collections from the Ports
-	Collection, run the following commands:</para>
+      <para>To install the above Type1 font collections from binary packages,
+	run the following commands:</para>
+
+      <screen>&prompt.root; <userinput>pkg install urwfonts</userinput></screen>
+
+      <para>Alternatively, to build from the Ports Collection, run the following
+	commands:</para>
 
       <screen>&prompt.root; <userinput>cd /usr/ports/x11-fonts/urwfonts</userinput>
 &prompt.root; <userinput>make install clean</userinput></screen>