docs/77736: [patch] FAQ X11 section updates

[David Adam]

>Number:         77736
>Category:       docs
>Synopsis:       [patch] FAQ X11 section updates
>Confidential:   no
>Severity:       non-critical
>Priority:       medium
>Responsible:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Sat Feb 19 16:20:21 GMT 2005
>Closed-Date:
>Last-Modified:
>Originator:     David Adam
>Release:        FreeBSD 5.3-STABLE i386
>Organization:
University Computer Club, UWA
>Environment:
FreeBSD owl 5.3-STABLE FreeBSD 5.3-STABLE #7: Sun Feb 13 12:56:22 WST 2005 root at owl:/usr/obj/usr/src/sys/OWL i386
>Description:
The X11 section of the FAQ contains several inconsistencies, as a result of the move to Xorg. This PR addresses three, detailed below.
>How-To-Repeat:
- Try to install X11 on FreeBSD using the instructions provided in the FAQ.
- Look for information in the init(8) manpage pertaining to X
- Try and find the X.org in the mouse section.

These are all minor oversights, really.
>Fix:
Patch also available from http://zanchey.ucc.asn.au/freebsd/faq.book.sgml.patch

(Submitted as part of http://zanchey.ucc.asn.au/archives/00000058.html)

--- faq.book.sgml.orig	2005-02-19 22:33:03.000000000 +0800
+++ faq.book.sgml	2005-02-20 00:06:19.000000000 +0800
@@ -7346,11 +7346,22 @@
 
           <para>The easiest way is to simply specify that you want to
             run X during the installation process.</para>
+	    
+	  <para>If you would like to add X to an existing installation, you
+	    should use the <filename role="package">x11/xorg</filename>
+	    meta-port, which will build and install all the necessary
+	    components.</para>
 
           <para>Then read and follow the documentation on the
-            <command>xf86config</command> tool, which assists you in
+            &man.xorgconfig.1; tool, which assists you in
             configuring &xfree86; for your particular graphics
-            card/mouse/etc.</para>
+            card/mouse/etc. You may also wish to examine the
+	    &man.xorgcfg.1; tool, which provides a graphical interface
+	    to the X configuration process.</para>
+
+	  <para>For further information, read the <ulink
+	    url="&url.books.handbook;/x11.html">X11</ulink> section of the
+	    FreeBSD Handbook.</para>
 
           <para>You may also wish to investigate the Xaccel server.
             See the section on <link linkend="xig">Xi Graphics</link> or
@@ -7368,8 +7379,9 @@
 
         <answer>
           <para>Your system is probably running at a raised securelevel.
-            It is not possible to start X at a raised
-            securelevel.  To see why, look at the &man.init.8; manual
+            It is not possible to start X at a raised securelevel, because
+            X requires write access to <devicename>/dev/io</devicename>.
+            For more information, see at the &man.init.8; manual
             page.</para>
 
           <para>So the question is what else you should do instead,
@@ -7408,9 +7420,10 @@
 Device          "/dev/sysmouse"
 .....</programlisting>
 
-          <para>The above example is for &xfree86; 3.3.2 or later.  For
-            earlier versions, the <emphasis>Protocol</emphasis> should be
-            <emphasis>MouseSystems</emphasis>.</para>
+          <para>The above example is for &xfree86; 3.3.2 or later, and
+	    for &xorg; 6.7.0.  For earlier versions, the
+	    <emphasis>Protocol</emphasis> should be
+	    <emphasis>MouseSystems</emphasis>.</para>
 
           <para>Some people prefer to use
             <devicename>/dev/mouse</devicename> under X.  To make this

>Release-Note:
>Audit-Trail:
>Unformatted: