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

[Benjamin Kaduk]

On Tue, 8 Oct 2013, Dru Lavigne wrote:

> Author: dru
> Date: Tue Oct  8 21:38:24 2013
> New Revision: 42905
> URL: http://svnweb.freebsd.org/changeset/doc/42905
>
> Log:
>  This patch does the following:
>  - adds pkg instructions to 6.3. Installing Xorg
>  - adds a Caveats section to 6.4. Xorg Configuration
>  - temporarily moves the extra config stuff to a new section called 6.8. Troubleshooting--this text has not yet been reviewed and this section may end up being instead called 6.8. Advanced Configuration or shuffled elsewhere in a subsequent patch
>  - replaces instances of X and X11 with the entity for xorg
>  - some updates to Synopsis, there will be more updates as the chapter is reviewed and shuffled
>
> Modified: head/en_US.ISO8859-1/books/handbook/x11/chapter.xml
> ==============================================================================
> --- head/en_US.ISO8859-1/books/handbook/x11/chapter.xml	Tue Oct  8 21:32:37 2013	(r42904)
> +++ head/en_US.ISO8859-1/books/handbook/x11/chapter.xml	Tue Oct  8 21:38:24 2013	(r42905)
> +    <note>
> +      <para>Users who prefer an installation method that automatically
> +	configures the <application>&xorg;</application> and offers

I think "the" is unnecessary, here.

> +	a choice of window managers during installation should
> +	refer to the <ulink
> +	  url="http://www.pcbsd.org/">pcbsd.org</ulink> website.</para>
> +    </note>

[...]

>
>       <para><application>&xorg;</application> uses
> 	<acronym>HAL</acronym> to autodetect keyboards and mice.  The
> 	<filename role="package">sysutils/hal</filename> and
> 	<filename role="package">devel/dbus</filename> ports are
> -	installed as dependencies of
> +	automatically installed as dependencies of
> 	<filename role="package">x11/xorg</filename>, but must be
> -	enabled by the following entries in the
> -	<filename>/etc/rc.conf</filename> file:</para>
> +	enabled by adding the following entries to
> +	<filename>/etc/rc.conf</filename>:</para>

I think we will want to revisit HAL at least in the near future.  (Less 
sure about dbus.)  Upstream X.org has moved away from HAL, and I am pretty 
sure that on current FreeBSD it is possible to run without HAL as well. 
There's a quarterly project report entry for getting dbus/X integration to 
fully replace HAL which gives the "near future" bit.  Unfortunately, I 
have lost track of what the current best practice is for X, HAL (or not), 
and dbus on FreeBSD.

-Ben