Skip site navigation (1)Skip section navigation (2)
Date:      Sat, 2 Feb 2002 12:39:42 +0000 (GMT)
From:      Andrew McKay <andy@openirc.co.uk>
To:        "Gary W. Swearingen" <swear@blarg.net>
Cc:        freebsd-doc@FreeBSD.ORG, <freebsd-gnats-submit@freebsd.org>
Subject:   Re: docs/34524: [PATCH] - Add important pre-installation notice
Message-ID:  <20020202121219.A62300-100000@fluoxetine.lan>
In-Reply-To: <0k3d0kk4ip.d0k@localhost.localdomain>

next in thread | previous in thread | raw e-mail | index | archive | help
On 1 Feb 2002, Gary W. Swearingen wrote:

> Looks good to me.  I tend to not like preachy docs, so I'd probably
> leave out that last bit of advice, but it's OK.

See revised patch below.  Did you mean lose the whole second paragraph?
I think pointing out the seriousness of this step is important so I've
left in the bit about the fact that the process CAN go wrong but removed
the bit telling people not to do it.  I would hope that being told your
motherboard could be permanently destroyed pretty much implies 'do not do
this unless you have a compelling reason'.  The whole paragraph could go
if it's a problem.

> And I'd change "fails to work" to "fails,", but that's OK as-is too.
> One more -- I'd probably change "Many" to "Some" at the beginning.

Agreed.  'fails to work' sounds worse on a re-read and 'Many' implies a
greater frequency than is actually true.

> (Is this what they call bikeshedding, or is it more-or-less welcome?)

Constructive criticism is something that I always find worthwhile.  Thanks
:)

-<PATCH>- also at: http://www.openirc.co.uk/freebsd/install.diff

--- chapter.sgml	Sat Feb  2 12:18:14 2002
+++ chapter.sgml.new	Sat Feb  2 12:22:45 2002
@@ -4553,6 +4553,18 @@
       questions and answers for people wishing to dual-boot FreeBSD with
       MS-DOS.</para>

+    <note>
+      <para>Some installation problems can be avoided or alleviated by
+        updating the firmware on various hardware components, most notably the
+        motherboard.  If the installation fails then updating the BIOS may
+        solve the problem.  Refer to your motherboard manufacturer's website
+        for information on BIOS revisions and upgrade instructions.</para>
+      <para>Most manufacturers strongly advise against upgrading motherboard
+        BIOSs unless you have a good reason for doing so.  The
+        process <emphasis>CAN</emphasis> go wrong, causing the BIOS to be
+        permanently destroyed.</para>
+    </note>
+
     <sect2>
       <title>What to Do If Something Goes Wrong...</title>

-</PATCH>-

-- 
Andrew McKay <andy@openirc.co.uk>


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?20020202121219.A62300-100000>