From nobody@FreeBSD.org  Fri Oct 24 14:36:03 2008
Return-Path: <nobody@FreeBSD.org>
Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34])
	by hub.freebsd.org (Postfix) with ESMTP id 89F6C106567D
	for <freebsd-gnats-submit@FreeBSD.org>; Fri, 24 Oct 2008 14:36:03 +0000 (UTC)
	(envelope-from nobody@FreeBSD.org)
Received: from www.freebsd.org (www.freebsd.org [IPv6:2001:4f8:fff6::21])
	by mx1.freebsd.org (Postfix) with ESMTP id 77B7E8FC2C
	for <freebsd-gnats-submit@FreeBSD.org>; Fri, 24 Oct 2008 14:36:03 +0000 (UTC)
	(envelope-from nobody@FreeBSD.org)
Received: from www.freebsd.org (localhost [127.0.0.1])
	by www.freebsd.org (8.14.3/8.14.3) with ESMTP id m9OEa37C097958
	for <freebsd-gnats-submit@FreeBSD.org>; Fri, 24 Oct 2008 14:36:03 GMT
	(envelope-from nobody@www.freebsd.org)
Received: (from nobody@localhost)
	by www.freebsd.org (8.14.3/8.14.3/Submit) id m9OEa3kn097957;
	Fri, 24 Oct 2008 14:36:03 GMT
	(envelope-from nobody)
Message-Id: <200810241436.m9OEa3kn097957@www.freebsd.org>
Date: Fri, 24 Oct 2008 14:36:03 GMT
From: Thomas Beery <tbeery@lanl.gov>
To: freebsd-gnats-submit@FreeBSD.org
Subject: Handbook 5.4.2 "Configuring X11" should suggest using window manager for screen resolution
X-Send-Pr-Version: www-3.1
X-GNATS-Notify:

>Number:         128342
>Category:       docs
>Synopsis:       Handbook 5.4.2 "Configuring X11" should suggest using window manager for screen resolution
>Confidential:   no
>Severity:       serious
>Priority:       medium
>Responsible:    blackend
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          change-request
>Submitter-Id:   current-users
>Arrival-Date:   Fri Oct 24 14:40:01 UTC 2008
>Closed-Date:    Tue Oct 28 07:57:45 UTC 2008
>Last-Modified:  Tue Oct 28 08:00:09 UTC 2008
>Originator:     Thomas Beery
>Release:        6.3
>Organization:
Los Alamos National Laboratory
>Environment:
FreeBSD tchrom.lanl.gov 6.3-RELEASE FreeBSD 6.3-RELEASE #0: Wed Jan 16 04:45:45 UTC 2008     root@dessler.cse.buffalo.edu:/usr/obj/usr/src/sys/SMP  i386

>Description:
Handbook section 5.4.2, "Configuring X11" says"
 
"As of version 7.3, Xorg can often work without any configuration file by simply typing at prompt:

% startx

If this does not work, or if the default configuration is not acceptable, then X11 must be configured manually. ....."

In my case a screen resolution of 1280x1024 at 60Hz on analog was desired. Startx gave a resolution of 1024x768. It was much easier to start XFce and change the resolution using the "Display Settings" tool than to edit /etc/X11/xorg.conf .
>How-To-Repeat:
Matrox M400 board, broken i2c/ddc, 1280x1024 @ 60Hz desired.
>Fix:
Change Handbook section 5.4.2 "Configuring X11" to read:

..

% startx

If the default configuration is not acceptable, continue with the installation of Gnome, KDE, or XFce and try to set resolution/frequency using the appropriate tool. If this does not work or "startx" does not display anything at all, then X11 must be configured manually.

>Release-Note:
>Audit-Trail:

From: Marc Fonvieille <blackend@FreeBSD.org>
To: Thomas Beery <tbeery@lanl.gov>
Cc: freebsd-gnats-submit@FreeBSD.org
Subject: Re: docs/128342: Handbook 5.4.2 "Configuring X11" should suggest
	using window manager for screen resolution
Date: Fri, 24 Oct 2008 18:43:28 +0200

 Hello,
 
 And what about people using just a window manager and not a desktop
 environment?
 
 I'd rather have see a note:
 
 -
 If this does not work, or if the default configuration is not
 acceptable, then X11 must be configured manually.
 
 Note: Desktop environments like GNOME, KDE or XFce have tools allowing
 the user to easily set the screen parameters such as the resolution.  So
 if the default configuration is not acceptable and you planned to
 install a desktop environment then just continue with the installation
 of the desktop environment and use the appropriate screen settings tool.
 
 Configuration of X11 is a multi-step process. The first step is to build
 an initial configuration file. As the super user, simply run:
 
 etc.
 -
 
 -- 
 Marc
Responsible-Changed-From-To: freebsd-doc->blackend 
Responsible-Changed-By: blackend 
Responsible-Changed-When: Sat Oct 25 17:11:30 UTC 2008 
Responsible-Changed-Why:  
Grab this PR.  I'll work on it. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=128342 
State-Changed-From-To: open->closed 
State-Changed-By: blackend 
State-Changed-When: Tue Oct 28 07:56:37 UTC 2008 
State-Changed-Why:  
I committed the suggestion I did in the trailing message.  Thanks for 
the help. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=128342 

From: dfilter@FreeBSD.ORG (dfilter service)
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/128342: commit references a PR
Date: Tue, 28 Oct 2008 07:56:41 +0000 (UTC)

 blackend    2008-10-28 07:56:33 UTC
 
   FreeBSD doc repository
 
   Modified files:
     en_US.ISO8859-1/books/handbook/x11 chapter.sgml 
   Log:
   Add a note mentioning many X11 parameters can be directly and easily set
   from desktop environments such as GNOME, KDE, etc.
   
   Discussed with: Thomas Beery <tbeery@lanl.gov>
   PR:             docs/128342
   
   Revision  Changes    Path
   1.190     +15 -2     doc/en_US.ISO8859-1/books/handbook/x11/chapter.sgml
 _______________________________________________
 cvs-all@freebsd.org mailing list
 http://lists.freebsd.org/mailman/listinfo/cvs-all
 To unsubscribe, send any mail to "cvs-all-unsubscribe@freebsd.org"
 
>Unformatted:
