[PATCH] OpenBSD.xml: Update xorg.conf information

[Matthieu Herrb]

On Tue, Nov 02, 2010 at 10:40:00PM -0700, Alan Coopersmith wrote:
> Remove xorgcfg & xorgconfig, replace with what's left.
> No longer describe xorg.conf as absolutely required.
> 
> Signed-off-by: Alan Coopersmith <alan.coopersmith at oracle.com>
> ---
> Open question: is /usr/X11R6/lib/X11/xorg.conf.eg still the right path
> for the sample config file on OpenBSD?
> 
>  general/platforms/OpenBSD.xml |   18 ++++++++++--------
>  1 files changed, 10 insertions(+), 8 deletions(-)
> 
> diff --git a/general/platforms/OpenBSD.xml b/general/platforms/OpenBSD.xml
> index a2f81b9..e915b6b 100644
> --- a/general/platforms/OpenBSD.xml
> +++ b/general/platforms/OpenBSD.xml
> @@ -107,14 +107,14 @@ Server support for OpenBSD/amd64.
>  <title>Configuring X for Your Hardware</title>
>  
>  <para>
> -The <filename>/etc/X11/xorg.conf</filename> file tells the X server what kind of
> -monitor,
> -video card and mouse you have.  You <emphasis>must</emphasis> create it to tell the
> -server what specific hardware you have.
> +The Xorg server will attempt to probe your video card, monitor, and input
> +devices and configure itself appropriately.   If it does not, or you want
> +to change the settings from the defaults, you can create an
> +<filename>/etc/X11/xorg.conf</filename> file with the settings you need.
>  </para>
>  
>  <para>
> -You'll need info on your hardware:
> +You may need info on your hardware, such as:
>  
>  <itemizedlist>
>  <listitem>
> @@ -141,9 +141,11 @@ Your monitor's sync frequencies.
>  </para>
>  
>  <para>
> -The recommended way to generate an <filename>xorg.conf</filename> file is to use the
> -<command>xorgcfg</command> utility.  The xorgconfig text utility is still there
> -for the (few) cases where xorgcfg can't be used. Also, there is a
> +The recommended way to generate an <filename>xorg.conf</filename> file
> +is to run <quote><userinput>Xorg -configure</userinput></quote>.
> +You may also want to start with the default configuration, which is
> +logged to <filename>/var/log/Xorg.0.log</filename> when no
> +<filename>xorg.conf</filename> is present. Also, there is a
>  sample file installed as <filename>/usr/X11R6/lib/X11/xorg.conf.eg</filename>,
>  which can be used as a starting point.
>  </para>
> -- 
> 1.7.3.2
> 

I would rather remove this document (and its brother NetBSD.xml)
completely. It was written for times where XFree86 was not yet
included in OpenBSD binary distributions and people had to download,
build and install it by themselve.

Now (well it's been more than 10 years) that X is included with
OpenBSD distributions, this document is mostly and contains many
other out of date information.

I you think something should stay in the xorg-docs packages, I will
try to write something that's more appropriate for today's situation:

 end users will get X binaries with the standard OpenBSD installation,
 point them to the OpenBSD READMEs and FAQ for more information. 

 developers may  need information on  how to build  individual packages
 out of  git repositories  at fd.o, if  they want to  try/contribute to
 bleeding edge X.

-- 
Matthieu Herrb