From nemesis!uhclem  Tue Oct 14 18:45:03 1997
Received: from nemesis.lonestar.org ([204.178.74.200])
          by hub.freebsd.org (8.8.7/8.8.7) with SMTP id SAA04055
          for <FreeBSD-gnats-submit>; Tue, 14 Oct 1997 18:45:02 -0700 (PDT)
          (envelope-from nemesis!uhclem)
Received: by nemesis.lonestar.org (Smail3.1.27.1 #22)
	id m0xLIUd-000twsC; Tue, 14 Oct 97 20:43 CDT
Message-Id: <m0xLIUd-000twsC@nemesis.lonestar.org>
Date: Tue, 14 Oct 97 20:43 CDT
From: uhclem@nemesis.lonestar.org
Reply-To: uhclem@nemesis.lonestar.org
To: FreeBSD-gnats-submit@freebsd.org
Subject: Out-of-date and minor errors in online install docs - FDIV074
X-Send-Pr-Version: 3.2

>Number:         4765
>Category:       misc
>Synopsis:       Out of date and minor errors in online install docs - FDIV074
>Confidential:   no
>Severity:       non-critical
>Priority:       medium
>Responsible:    freebsd-bugs
>State:          closed
>Quarter:
>Keywords:
>Date-Required:
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Tue Oct 14 18:50:01 PDT 1997
>Closed-Date:    Tue Oct 14 21:37:31 PDT 1997
>Last-Modified:  Tue Oct 14 21:40:01 PDT 1997
>Originator:     Frank Durda IV
>Release:        FreeBSD 2.2.5-971013-BETA i386
>Organization:
None
>Environment:

FreeBSD 2.2.5-971013-BETA boot floppy

>Description:

Several documentation problems exhibit themselves in the online documentation
on the install floppy.  Undoubtedly, some of these errors or out-of-date
information also in free-standing files, possibly even on the CD-ROM
paper inserts.   Update everywhere.

1.	In Doc->Usage,		"RETURN" is used in the glossary of what keys
	do what during the install, although you won't find "RETURN" on any
	PC keyboard built in the past 15 years.  Correct notation should be
	"Enter" or "ENTER".   Yeah, I prefer using "return" too, but there is
	no point in having newbies searching their keyboards looking for a
	button that isn't labeled that way.

2.	In Doc -> README	References to "2.2x" and "RELENG" version.
	These probably need to be updated as we approach 2.2.5 release.


3.	In Doc -> README	This is actually a software bug but only
	seems to occur in the Doc section.  Hitting <Esc> does nothing in the
	README (and similar) screens.  However, if you later hit <Enter> to
	exit the screen, it flashes the previous screen and re-enters the
	same README screen (or whichever screen you were in).
	It is as though the escape is not completely ignored and gets saved
	somewhere, and on exit the RETURN not only gets you out of the doc
	section you were in, but acts as an acceptance of going into the doc
	section that had focus.   Since other screens in the Install take
	<Esc> to be a shortcut for <Cancel> or get-outta-here operations,
	it seems like <Esc> should do the same here, or <Esc> should be
	completely discarded while in the Doc sections and pressing it should
	not affect later operations as it does now.

4.	In the hardware section, the phrase "nor can be" should probably
	be "nor can they be".  This is in the area talking about how
	you can't change settings on EISA or PCI cards using the kernel
	boot-time config utility.

5.	Relnotes - the supported hardware info seems to have info that is
	seriously out of date.  is IDE CD-ROM support still considered to
	be "alpha quality"?  This (and the supported hardware list that goes
	on the back of the CD-ROM box) need to be updated by someone familiar
	with the list of what we really do support now.


>How-To-Repeat:

Boot the from the boot disk and linger in the documentation sections.

>Fix:
	
>Release-Note:
>Audit-Trail:
State-Changed-From-To: open->closed 
State-Changed-By: jkh 
State-Changed-When: Tue Oct 14 21:37:31 PDT 1997 
State-Changed-Why:  
Done. 

From: "Jordan K. Hubbard" <jkh@time.cdrom.com>
To: uhclem@nemesis.lonestar.org
Cc: FreeBSD-gnats-submit@FreeBSD.ORG
Subject: Re: misc/4765: Out-of-date and minor errors in online install docs - FDIV074 
Date: Tue, 14 Oct 1997 21:35:20 -0700

 > 1.	In Doc->Usage,		"RETURN" is used in the glossary of what keys
 Fixed.
 
 > 2.	In Doc -> README	References to "2.2x" and "RELENG" version.
 Those will be dealt with as we get closer.  I don't want the BETA snapshots
 to start announcing themselves as the full release, natch? :)
 
 > 3.	In Doc -> README	This is actually a software bug but only
 > 	seems to occur in the Doc section.  Hitting <Esc> does nothing in the
 
 Hmmm.  I don't think that making the textbox object deal with <ESC> is
 going to be something I'll be able to do before release.
 
 > 4.	In the hardware section, the phrase "nor can be" should probably
 
 Fixed.
 
 > 5.	Relnotes - the supported hardware info seems to have info that is
 > 	seriously out of date.  is IDE CD-ROM support still considered to
 
 Fixed, though I'm not sure that we're listing *all* the new hardware
 we support now.  Anyone else wishing to review these release notes for
 2.2.5 is more than welcome! :)
 
 Thanks.
 
 					Jordan
>Unformatted:
