Date: Fri, 15 Feb 2002 00:45:40 -0500 (EST) From: Tom Rhodes <darklogik@pittgoth.com> To: FreeBSD-gnats-submit@freebsd.org Subject: docs/34953: [PATCH] Handbook, cleaning prs Message-ID: <200202150545.g1F5jeE06576@pittgoth.com>
next in thread | raw e-mail | index | archive | help
>Number: 34953
>Category: docs
>Synopsis: [PATCH] Handbook, cleaning prs
>Confidential: no
>Severity: non-critical
>Priority: medium
>Responsible: freebsd-doc
>State: open
>Quarter:
>Keywords:
>Date-Required:
>Class: doc-bug
>Submitter-Id: current-users
>Arrival-Date: Thu Feb 14 21:50:01 PST 2002
>Closed-Date:
>Last-Modified:
>Originator:
>Release: FreeBSD 4.5 i386
>Organization:
>Environment:
System: FreeBSD localhost 4.5
>Description:
Handbook incorrect about how to add another
hard disk using sysinstall(8), corrected. Added some
troubleshooting information to the install chapter, Andy
I really liked your patch, but I added some to it and changed
the wording a bit, hope you do not mind. Removed the remark
about "avoiding X Windows" and replaced it with something a
tad bit more friendly. Quick grammer fix! I used diff -ru (as
you can see from the patch, and I have tested and aspelled it)
This pr also succeeds in closing pr: 34074 pr: 34524 and pr: 32901
>How-To-Repeat:
Look at the pr database, read the handbook
>Fix:
apply this simple patch to close 3 prs not counting its
own. Thanks
diff -ru handbook.old/disks/chapter.sgml handbook/disks/chapter.sgml
--- handbook.old/disks/chapter.sgml Fri Feb 15 00:09:14 2002
+++ handbook/disks/chapter.sgml Fri Feb 15 00:34:05 2002
@@ -193,18 +193,12 @@
<command>/stand/sysinstall</command> and enter the
<literal>Configure</literal> menu. Within the
<literal>FreeBSD Configuration Menu</literal>, scroll down and
- select the <literal>Partition</literal> item. Next you should
- be presented with a list of hard drives installed in your
- system. If you do not see <literal>da1</literal> listed, you
- need to recheck your physical installation and
- <command>dmesg</command> output in the file
- <filename>/var/run/dmesg.boot</filename>.</para>
+ select the <literal>Fdisk</literal> option.</para>
</step>
<step>
- <title>FDISK Partition Editor</title>
- <para>Select <literal>da1</literal> to enter the <literal>FDISK
- Partition Editor</literal>. Type <userinput>A</userinput> to
+ <title>FDISK Partition Editor</title>
+ <para>Once inside FDISK, we can type <userinput>A</userinput> to
use the entire disk for FreeBSD. When asked if you want to
<quote>remain cooperative with any future possible operating
systems</quote>, answer <literal>YES</literal>. Write the
@@ -219,13 +213,14 @@
<title>Disk Label Editor</title>
<indexterm><primary>BSD partitions</primary></indexterm>
- <para>Next, <application>Sysinstall</application> will
+ <para>Next, you need to exit <application>Sysinstall</application>
+ and start it again. Follow the directions above, although this
+ time choose the <literal>Label</literal> option. This will
enter the <literal>Disk Label Editor</literal>. This
is where you will create the traditional BSD partitions. A
disk can have up to eight partitions, labeled
<literal>a-h</literal>.
- A few of
- the partition labels have special uses. The
+ A few of the partition labels have special uses. The
<literal>a</literal> partition is used for the root partition
(<filename>/</filename>). Thus only your system disk (e.g,
the disk you boot from) should have an <literal>a</literal>
diff -ru handbook.old/install/chapter.sgml handbook/install/chapter.sgml
--- handbook.old/install/chapter.sgml Fri Feb 15 00:09:15 2002
+++ handbook/install/chapter.sgml Fri Feb 15 00:28:05 2002
@@ -4585,6 +4585,21 @@
that case, the probes for the conflicting driver(s) should be
disabled.</para>
+ <note>
+ <para>Some installation problems can be avoided or alleviated by
+ by updating the firmware on various hardware components, most notably
+ the motherboard. The motherboard firmware may also be referred to
+ as <acronym>BIOS</acronym> and most of the motherboard or computer
+ manufactures have a website where the upgrades and upgrade information
+ may be located.</para>
+
+ <para>Most manufacturers strongly advise against upgrading the motherboard
+ <acronym>BIOS</acronym> unless there is a good reason for doing so, which
+ could possibly be a critical update of sorts. The upgrade process
+ <emphasis>can</emphasis> go wrong, causing permanent damage to the
+ <acronym>BIOS</acronym> chip.</para>
+ </note>
+
<warning>
<para>Do not disable any drivers you will need during the
installation, such as your screen (<devicename>sc0</devicename>).
diff -ru handbook.old/x11/chapter.sgml handbook/x11/chapter.sgml
--- handbook.old/x11/chapter.sgml Fri Feb 15 00:09:12 2002
+++ handbook/x11/chapter.sgml Fri Feb 15 00:40:31 2002
@@ -59,9 +59,9 @@
letter in the Roman alphabet.</para>
<para>X can be called <quote>X</quote>, <quote>X Window System</quote>,
- <quote>X11</quote>, and other terms. <quote>X Windows</quote> is
- to be avoided wherever possible; see &man.X.1; for more
- information.</para>
+ <quote>X11</quote>, and other terms. Calling X11
+ <quote>X Windows</quote> is can offend some people;
+ see &man.X.1; for a bit more insight on this.</para>
</sect2>
<sect2>
>Release-Note:
>Audit-Trail:
>Unformatted:
To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?200202150545.g1F5jeE06576>