Date: Tue, 14 Oct 97 20:43 CDT From: uhclem@nemesis.lonestar.org To: FreeBSD-gnats-submit@FreeBSD.ORG Subject: misc/4765: Out-of-date and minor errors in online install docs - FDIV074 Message-ID: <m0xLIUd-000twsC@nemesis.lonestar.org> Resent-Message-ID: <199710150150.SAA04273@hub.freebsd.org>
next in thread | raw e-mail | index | archive | help
>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: open >Class: doc-bug >Submitter-Id: current-users >Arrival-Date: Tue Oct 14 18:50:01 PDT 1997 >Last-Modified: >Originator: Frank Durda IV >Organization: None >Release: FreeBSD 2.2.5-971013-BETA i386 >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: >Audit-Trail: >Unformatted:
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?m0xLIUd-000twsC>