From bmah@packetdesign.com  Tue Oct 29 09:10:38 2002
Return-Path: <bmah@packetdesign.com>
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id AC9BC37B401
	for <FreeBSD-gnats-submit@freebsd.org>; Tue, 29 Oct 2002 09:10:38 -0800 (PST)
Received: from mailman.packetdesign.com (dns.packetdesign.com [65.192.41.10])
	by mx1.FreeBSD.org (Postfix) with ESMTP id 3B88943E8A
	for <FreeBSD-gnats-submit@freebsd.org>; Tue, 29 Oct 2002 09:10:38 -0800 (PST)
	(envelope-from bmah@packetdesign.com)
Received: from nimitz.packetdesign.com (nimitz.packetdesign.com [192.168.0.184])
	by mailman.packetdesign.com (8.12.3/8.11.6) with ESMTP id g9THAbOU056776
	for <FreeBSD-gnats-submit@freebsd.org>; Tue, 29 Oct 2002 09:10:37 -0800 (PST)
	(envelope-from bmah@packetdesign.com)
Received: from nimitz.packetdesign.com (localhost [IPv6:::1])
	by nimitz.packetdesign.com (8.12.6/8.12.6) with ESMTP id g9THAbCR017783
	for <FreeBSD-gnats-submit@freebsd.org>; Tue, 29 Oct 2002 09:10:37 -0800 (PST)
	(envelope-from bmah@nimitz.packetdesign.com)
Received: (from bmah@localhost)
	by nimitz.packetdesign.com (8.12.6/8.12.6/Submit) id g9THAbIt017782;
	Tue, 29 Oct 2002 09:10:37 -0800 (PST)
Message-Id: <200210291710.g9THAbIt017782@nimitz.packetdesign.com>
Date: Tue, 29 Oct 2002 09:10:37 -0800 (PST)
From: "Bruce A. Mah" <bmah@freebsd.org>
Reply-To: "Bruce A. Mah" <bmah@freebsd.org>
To: FreeBSD-gnats-submit@freebsd.org
Cc:
Subject: Handbook only documents UserConfig for boot-time kernel config
X-Send-Pr-Version: 3.113
X-GNATS-Notify:

>Number:         44595
>Category:       docs
>Synopsis:       Handbook only documents UserConfig for boot-time kernel config
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Tue Oct 29 09:20:01 PST 2002
>Closed-Date:    Wed Nov 27 15:04:47 PST 2002
>Last-Modified:  Wed Nov 27 15:04:47 PST 2002
>Originator:     Bruce A. Mah
>Release:        FreeBSD 4.7-STABLE i386
>Organization:
>Environment:
System: FreeBSD nimitz.packetdesign.com 4.7-STABLE FreeBSD 4.7-STABLE #45: Mon Oct 14 11:50:11 PDT 2002 root@nimitz.packetdesign.com:/usr/obj/usr/src/sys/NIMITZ i386


	
>Description:

5.0-CURRENT doesn't have UserConfig, which is used on the i386 (and pc98?)
for configuring parameters of various
(mostly-legacy) devices.  The replacement is the device.hints(5) mechanism,
which has most of the functionality, but a very different user interface.

The Handbook should reflect this (or at least mention there is 
a difference).

>How-To-Repeat:
	
>Fix:

At a minimum, turn the above ramblings into English and insert into
the installation chapter of the Handbook.  It'd be better to have a real
"How to do boot-time kernel configuration on 5.X" section, but that's
more work.

>Release-Note:
>Audit-Trail:

From: Tom Rhodes <trhodes@FreeBSD.org>
To: freebsd-gnats-submit@FreeBSD.org, bmah@FreeBSD.org
Cc:  
Subject: Re: docs/44595: Handbook only documents UserConfig for boot-time kernel config
Date: Wed, 6 Nov 2002 22:53:43 -0500

 Isn't this what we use device.hints(5) for?  Or do we need to document
 yet another mechanism for configuring things at during the boot
 operation?
 
 --
 Tom Rhodes

From: bmah@FreeBSD.org (Bruce A. Mah)
To: Tom Rhodes <trhodes@FreeBSD.org>
Cc: freebsd-gnats-submit@FreeBSD.org, bmah@FreeBSD.org
Subject: Re: docs/44595: Handbook only documents UserConfig for boot-time kernel config 
Date: Thu, 07 Nov 2002 08:14:30 -0800

 --==_Exmh_-483719590P
 Content-Type: text/plain; charset=us-ascii
 
 If memory serves me right, Tom Rhodes wrote:
 > Isn't this what we use device.hints(5) for?  Or do we need to document
 > yet another mechanism for configuring things at during the boot
 > operation?
 
 Yes, that's what device.hints(5) does.  The problem is that there is no
 mention of this mechanism in the handbook's install chapter *at all*.
 Unless we at least mention device.hints(5), we're going to get a lot of
 confused new 5.0 users asking "Where's my UserConfig?"
 
 Bruce.
 
 
 
 --==_Exmh_-483719590P
 Content-Type: application/pgp-signature
 
 -----BEGIN PGP SIGNATURE-----
 Version: GnuPG v1.2.0 (FreeBSD)
 Comment: Exmh version 2.5+ 20020506
 
 iD8DBQE9ypFl2MoxcVugUsMRAgDsAJ9vFt9AscKZHN9UlM0dVxsKjFIApwCeOFVj
 5jI0ero36XQG2Lc6wqA5QFM=
 =bdvH
 -----END PGP SIGNATURE-----
 
 --==_Exmh_-483719590P--

From: Tom Rhodes <trhodes@FreeBSD.org>
To: bmah@FreeBSD.org
Cc: freebsd-gnats-submit@FreeBSD.org
Subject: Re: docs/44595: Handbook only documents UserConfig for boot-time kernel config
Date: Thu, 7 Nov 2002 16:12:38 -0500

 On Thu, 07 Nov 2002 08:14:30 -0800
 bmah@FreeBSD.org (Bruce A. Mah) wrote:
 
 > If memory serves me right, Tom Rhodes wrote:
 > > Isn't this what we use device.hints(5) for?  Or do we need to
 > > document yet another mechanism for configuring things at during the
 > > boot operation?
 > 
 > Yes, that's what device.hints(5) does.  The problem is that there is
 > no mention of this mechanism in the handbook's install chapter *at
 > all*. Unless we at least mention device.hints(5), we're going to get a
 > lot of confused new 5.0 users asking "Where's my UserConfig?"
 > 
 > Bruce.
 > 
 > 
 > 
 
 I added information about device.hints(5) to the boot chapter.  Would
 a quick paragraph which:
 
 Explains that UserConfig is not in 5.0
 Users must see the device.hints(5) manual page and/or
 Read THIS section of the handbook for information on device.hints(5)
 
 be sufficient?  Or do you have a better approach?
 
 --
 Tom Rhodes

From: bmah@FreeBSD.org (Bruce A. Mah)
To: Tom Rhodes <trhodes@FreeBSD.org>
Cc: bmah@FreeBSD.org, freebsd-gnats-submit@FreeBSD.org
Subject: Re: docs/44595: Handbook only documents UserConfig for boot-time kernel config 
Date: Thu, 07 Nov 2002 18:10:04 -0800

 --==_Exmh_1945237144P
 Content-Type: text/plain; charset=us-ascii
 
 If memory serves me right, Tom Rhodes wrote:
 
 > I added information about device.hints(5) to the boot chapter.  Would
 > a quick paragraph which:
 > 
 > Explains that UserConfig is not in 5.0
 
 OK.  Remember that it's not just "not in 5.0", but "not in releases 
 beginning with 5.0" or something like that.
 
 > Users must see the device.hints(5) manual page and/or
 
 It's really hard to read the manpage if you're installing for the first 
 time.  :-)
 
 > Read THIS section of the handbook for information on device.hints(5)
 
 A new user is less likely to want to know about the booting process than
 what steps they need to do to get some grotty old ISA Ethernet board to
 work.  It's best if you can keep the new text self-contained...I'd like 
 to use the install chapter in the handbook to replace INSTALL.TXT 
 someday.
 
 > be sufficient?  Or do you have a better approach?
 
 Bruce.
 
 
 
 --==_Exmh_1945237144P
 Content-Type: application/pgp-signature
 
 -----BEGIN PGP SIGNATURE-----
 Version: GnuPG v1.2.0 (FreeBSD)
 Comment: Exmh version 2.5+ 20020506
 
 iD8DBQE9yxz82MoxcVugUsMRAsEAAJ9/j0WkT+1ViWwPsCz3Q2E3huVgPQCgthbd
 VYPxy4Z5XttXWsLXLwr1Vt0=
 =Rcam
 -----END PGP SIGNATURE-----
 
 --==_Exmh_1945237144P--

From: Tom Rhodes <trhodes@FreeBSD.org>
To: bmah@FreeBSD.org
Cc: freebsd-gnats-submit@FreeBSD.org
Subject: Re: docs/44595: Handbook only documents UserConfig for boot-time kernel config
Date: Thu, 7 Nov 2002 22:31:00 -0500

 On Thu, 07 Nov 2002 18:10:04 -0800
 bmah@FreeBSD.org (Bruce A. Mah) wrote:
 
 > If memory serves me right, Tom Rhodes wrote:
 > 
 > > I added information about device.hints(5) to the boot chapter. 
 > > Would a quick paragraph which:
 > > 
 > > Explains that UserConfig is not in 5.0
 > 
 > OK.  Remember that it's not just "not in 5.0", but "not in releases 
 > beginning with 5.0" or something like that.
 > 
 > > Users must see the device.hints(5) manual page and/or
 > 
 > It's really hard to read the manpage if you're installing for the
 > first time.  :-)
 > 
 > > Read THIS section of the handbook for information on device.hints(5)
 > 
 > A new user is less likely to want to know about the booting process
 > than what steps they need to do to get some grotty old ISA Ethernet
 > board to work.  It's best if you can keep the new text
 > self-contained...I'd like to use the install chapter in the handbook
 > to replace INSTALL.TXT someday.
 > 
 > > be sufficient?  Or do you have a better approach?
 > 
 > Bruce.
 > 
 > 
 > 
 
 Perhaps I'll just 'draft' a paragraph and you review it before I
 do the actual commit.  This will keep changes to 1 and hopefully is
 good enough to please everyone.
 
 --
 Tom Rhodes
State-Changed-From-To: open->closed 
State-Changed-By: trhodes 
State-Changed-When: Wed Nov 27 15:03:59 PST 2002 
State-Changed-Why:  
Link and explination added to the kernelconfig && install chapters. 

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