From nobody@FreeBSD.org  Sat Oct 29 16:41:51 2011
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 4DFE81065674
	for <freebsd-gnats-submit@FreeBSD.org>; Sat, 29 Oct 2011 16:41:51 +0000 (UTC)
	(envelope-from nobody@FreeBSD.org)
Received: from red.freebsd.org (red.freebsd.org [IPv6:2001:4f8:fff6::22])
	by mx1.freebsd.org (Postfix) with ESMTP id 3DF108FC08
	for <freebsd-gnats-submit@FreeBSD.org>; Sat, 29 Oct 2011 16:41:51 +0000 (UTC)
Received: from red.freebsd.org (localhost [127.0.0.1])
	by red.freebsd.org (8.14.4/8.14.4) with ESMTP id p9TGfows093733
	for <freebsd-gnats-submit@FreeBSD.org>; Sat, 29 Oct 2011 16:41:50 GMT
	(envelope-from nobody@red.freebsd.org)
Received: (from nobody@localhost)
	by red.freebsd.org (8.14.4/8.14.4/Submit) id p9TGfoOg093732;
	Sat, 29 Oct 2011 16:41:50 GMT
	(envelope-from nobody)
Message-Id: <201110291641.p9TGfoOg093732@red.freebsd.org>
Date: Sat, 29 Oct 2011 16:41:50 GMT
From: "r. clayton" <rclayton@monmouth.edu>
To: freebsd-gnats-submit@FreeBSD.org
Subject: Handbook section 6.4.2 misordering.
X-Send-Pr-Version: www-3.1
X-GNATS-Notify:

>Number:         162154
>Category:       docs
>Synopsis:       [handbook] section 6.4.2 misordering.
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    manolis
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Sat Oct 29 16:50:01 UTC 2011
>Closed-Date:    Sun Oct 30 17:37:52 UTC 2011
>Last-Modified:  Sun Oct 30 17:37:52 UTC 2011
>Originator:     r. clayton
>Release:        8.2
>Organization:
monmouth u.
>Environment:
FreeBSD WestRunton 8.2-RELEASE FreeBSD 8.2-RELEASE #0: Fri Feb 18 02:24:46 UTC 2011 root@almeida.cse.buffalo.edu:/usr/obj/usr/src/sys/GENERIC  i386
>Description:
The two paragraphs

  As of version 7.3, Xorg can often work without any configuration file by
  simply typing at prompt:

    % startx

  Starting with version 7.4, Xorg can use HAL to autodetect keyboards and
  mice. The sysutils/hal and devel/dbus ports are installed as dependencies of
  x11/xorg, but must be enabled by the following entries in the /etc/rc.conf
  file:

    hald_enable="YES"
    dbus_enable="YES"

  These services should be started (either manually or by rebooting) before
  further Xorg configuration is attempted.

in section 6.4.2 of 

  http://www.freebsd.org/doc/handbook/x-config.html

are in reverse order.  My experience has been running startx without enabling hald and dbus leaves me without a mouse or keyboard.
>How-To-Repeat:
Install xorg from ports, stop reading section 6.4 after the startx part, run startx.
>Fix:
It might be more accurate and helpful to flip the two paragraphs, something like

  Starting with version 7.4, Xorg can use HAL to autodetect keyboards and
  mice. The sysutils/hal and devel/dbus ports are installed as dependencies of
  x11/xorg, but must be enabled by the following entries in the /etc/rc.conf
  file:

    hald_enable="YES"
    dbus_enable="YES"

  These services should be started (either manually or by rebooting) before
  further Xorg configuration is attempted.

  As of version 7.3, Xorg can often work without any configuration file by
  simply typing at prompt:

    % startx

with suitable adjustments to the sentence starting "These services..." to
indicate that not only should these services be enabled before configuration,
but before using X11 at all.


>Release-Note:
>Audit-Trail:

From: Manolis Kiagias <sonic2000gr@gmail.com>
To: "r. clayton" <rclayton@monmouth.edu>
Cc: freebsd-gnats-submit@FreeBSD.org
Subject: Re: docs/162154: Handbook section 6.4.2 misordering.
Date: Sat, 29 Oct 2011 20:36:18 +0300

 On 29/10/2011 7:41 , r. clayton wrote:
 >
 > Description:
 > The two paragraphs
 >
 >    As of version 7.3, Xorg can often work without any configuration file by
 >    simply typing at prompt:
 >
 >      % startx
 >
 >    Starting with version 7.4, Xorg can use HAL to autodetect keyboards and
 >    mice. The sysutils/hal and devel/dbus ports are installed as dependencies of
 >    x11/xorg, but must be enabled by the following entries in the /etc/rc.conf
 >    file:
 >
 >      hald_enable="YES"
 >      dbus_enable="YES"
 >
 >    These services should be started (either manually or by rebooting) before
 >    further Xorg configuration is attempted.
 >
 > in section 6.4.2 of
 >
 >    http://www.freebsd.org/doc/handbook/x-config.html
 >
 > are in reverse order.  My experience has been running startx without enabling hald and dbus leaves me without a mouse or keyboard.
 >> How-To-Repeat:
 > Install xorg from ports, stop reading section 6.4 after the startx part, run startx.
 
 Heh, not a good idea to stop reading at the middle of the section :)
 But I totally agree with you about the ordering of the paragraphs.
 
 >> Fix:
 > It might be more accurate and helpful to flip the two paragraphs, something like
 >
 >    Starting with version 7.4, Xorg can use HAL to autodetect keyboards and
 >    mice. The sysutils/hal and devel/dbus ports are installed as dependencies of
 >    x11/xorg, but must be enabled by the following entries in the /etc/rc.conf
 >    file:
 >
 >      hald_enable="YES"
 >      dbus_enable="YES"
 >
 >    These services should be started (either manually or by rebooting) before
 >    further Xorg configuration is attempted.
 >
 >    As of version 7.3, Xorg can often work without any configuration file by
 >    simply typing at prompt:
 >
 >      % startx
 >
 > with suitable adjustments to the sentence starting "These services..." to
 > indicate that not only should these services be enabled before configuration,
 > but before using X11 at all.
 >
 
 In fact, I think we can completely remove the version information at 
 this point. We've had 7.5 in the ports for some time now, I doubt anyone 
 would install 7.2 now - the reference only serves historical purposes. I 
 would suggest something like the following:
 
 "Xorg  uses HAL to autodetect keyboards and mice. The sysutils/hal and 
 devel/dbus ports are installed as dependencies of x11/xorg, but must be 
 enabled by the following entries in the /etc/rc.conf file:
 
 hald_enable="YES"
 dbus_enable="YES"
 These services should be started (either manually or by rebooting) 
 before further Xorg configuration or use is attempted.
 
 Xorg can often work without any further configuration steps, by simply 
 typing at prompt:
 
 % startx
 
 The automatic configuration may fail to work with some hardware, or may 
 not set things up quite as desired. In these cases, manual configuration 
 will be necessary...."
Responsible-Changed-From-To: freebsd-doc->manolis 
Responsible-Changed-By: manolis 
Responsible-Changed-When: Sat Oct 29 18:11:44 UTC 2011 
Responsible-Changed-Why:  
I'll handle this one 

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

From: Manolis Kiagias <sonic2000gr@gmail.com>
To: bug-followup@FreeBSD.org, rclayton@monmouth.edu
Cc: "doc@FreeBSD.org" <doc@FreeBSD.org>
Subject: Re: docs/162154: [handbook] section 6.4.2 misordering.
Date: Sat, 29 Oct 2011 21:09:53 +0300

 Here is a complete patch, also with version information removed:
 
 http://www.freebsdgr.org/all/en_US.ISO8859-1/books/handbook/x11/x11.patch
 
 And a test build here:
 
 http://www.freebsdgr.org/all/en_US.ISO8859-1/books/handbook/x-config.html
 
 This clears up the chapter a bit, I doubt we need to reference 7.3 and 
 earlier versions specifically anymore. Any objections?

From: Glen Barber <gjb@FreeBSD.org>
To: Manolis Kiagias <sonic2000gr@gmail.com>
Cc: bug-followup@FreeBSD.org, rclayton@monmouth.edu, 
 "doc@FreeBSD.org" <doc@FreeBSD.org>
Subject: Re: docs/162154: [handbook] section 6.4.2 misordering.
Date: Sat, 29 Oct 2011 16:53:10 -0400

 This is an OpenPGP/MIME signed message (RFC 2440 and 3156)
 --------------enig4A6B6EFAC80509008463CDDE
 Content-Type: text/plain; charset=ISO-8859-7
 Content-Transfer-Encoding: quoted-printable
 
 Hi Manolis,
 
 On 10/29/11 2:09 PM, Manolis Kiagias wrote:
 > Here is a complete patch, also with version information removed:
 >=20
 > http://www.freebsdgr.org/all/en_US.ISO8859-1/books/handbook/x11/x11.pat=
 ch
 >=20
 > And a test build here:
 >=20
 > http://www.freebsdgr.org/all/en_US.ISO8859-1/books/handbook/x-config.ht=
 ml
 >=20
 > This clears up the chapter a bit, I doubt we need to reference 7.3 and
 > earlier versions specifically anymore. Any objections?
 
 I think it looks good.  I say go for it. :-)
 
 --=20
 Glen Barber | gjb@FreeBSD.org
 FreeBSD Documentation Project
 
 
 --------------enig4A6B6EFAC80509008463CDDE
 Content-Type: application/pgp-signature; name="signature.asc"
 Content-Description: OpenPGP digital signature
 Content-Disposition: attachment; filename="signature.asc"
 
 -----BEGIN PGP SIGNATURE-----
 Version: GnuPG v1.4.11 (Darwin)
 
 iQEcBAEBCAAGBQJOrGe6AAoJEFJPDDeguUajHYkIALuKZh2aMjjOLbYgHOqClrk8
 YS0S6AavaavULSEfJ8uk22CsjdqMfjHkpGf70Siv+xhDVHcQaKLBu7Kd8DPWYnOj
 ijCFiIUfCIi0RjIvhSrFtDJ1gSJlvjG3n0T+fJOhKA+7ZcMuJV2+pueOO1d0C1BX
 lsFiBj+qh5evrbIGqW+Q2n5un0wUgif1orRcqEb5UnpuQzEhRePpR9V5QdFFeSUr
 gxvRKwIT/Torpyn5GM252+d9QOUZR2BvAh+SKlJk5dShj8MeKo0BWciDvp52j+Rg
 C5kDKpLr2AoBmXYn7b/iLzXnRkE8+I9VMqK126Lt9rSGeAhf3kf7Prh9it/LoJA=
 =t/LE
 -----END PGP SIGNATURE-----
 
 --------------enig4A6B6EFAC80509008463CDDE--

From: Manolis Kiagias <sonic2000gr@gmail.com>
To: "R. Clayton" <rclayton@monmouth.edu>
Cc: bug-followup@FreeBSD.org, doc@FreeBSD.org
Subject: Re: docs/162154: [handbook] section 6.4.2 misordering.
Date: Sun, 30 Oct 2011 15:04:59 +0200

 On 30/10/2011 2:54 , R. Clayton wrote:
 >    Here is a complete patch, also with version information removed:
 >
 > Thanks for the quick, and positive, response.  I've run across a few other
 > places in the handbook with reversed ordering; I've written them down
 > somewhere, but don't remember where.  I'll try to find them, and submit them if
 > they're still relevant.
 >
 
 Thanks for submitting this. The patch will probably be committed later 
 on today.
 If you do find your notes, we'll be glad to hear from you again.
 
 Thanks for helping improve FreeBSD!

From: rclayton@monmouth.edu (R. Clayton)
To: Manolis Kiagias <sonic2000gr@gmail.com>
Cc: bug-followup@FreeBSD.org, doc@FreeBSD.org
Subject: Re: docs/162154: [handbook] section 6.4.2 misordering.
Date: Sun, 30 Oct 2011 08:54:21 -0400

   Here is a complete patch, also with version information removed:
 
 Thanks for the quick, and positive, response.  I've run across a few other
 places in the handbook with reversed ordering; I've written them down
 somewhere, but don't remember where.  I'll try to find them, and submit them if
 they're still relevant.

From: dfilter@FreeBSD.ORG (dfilter service)
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/162154: commit references a PR
Date: Sun, 30 Oct 2011 17:29:23 +0000 (UTC)

 manolis     2011-10-30 17:29:14 UTC
 
   FreeBSD doc repository
 
   Modified files:
     en_US.ISO8859-1/books/handbook/x11 chapter.sgml 
   Log:
   Clean up the section on Configuring X11:
   
   - Reorder the first two paragraphs [1]
   - Retire information concerning no longer relevant Xorg versions
   
   PR:             docs/162154 [1]
   Reported by:    R. Clayton <rclayton at monmouth dot edu>
   Reviewed by:    gjb
   
   Revision  Changes    Path
   1.208     +19 -27    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"
 
State-Changed-From-To: open->closed 
State-Changed-By: manolis 
State-Changed-When: Sun Oct 30 17:37:05 UTC 2011 
State-Changed-Why:  
Changes were committed, and will appear on the website soon. 
Thanks for the report! 

http://www.freebsd.org/cgi/query-pr.cgi?pr=162154 
>Unformatted:
