Date: Sat, 2 Feb 2002 05:50:03 -0800 (PST) From: Andrew McKay <andy@openirc.co.uk> To: freebsd-doc@freebsd.org Subject: Re: docs/34524: [PATCH] - Add important pre-installation notice Message-ID: <200202021350.g12Do3a18562@freefall.freebsd.org>
next in thread | raw e-mail | index | archive | help
The following reply was made to PR docs/34524; it has been noted by GNATS. 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 Date: Sat, 2 Feb 2002 12:39:42 +0000 (GMT) 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?200202021350.g12Do3a18562>