From owner-freebsd-doc Sat Jan 13 5:41:14 2001 Delivered-To: freebsd-doc@freebsd.org Received: from spammie.svbug.com (unknown [198.79.110.2]) by hub.freebsd.org (Postfix) with ESMTP id A648E37B400 for ; Sat, 13 Jan 2001 05:40:57 -0800 (PST) Received: from spammie.svbug.com (localhost.mozie.org [127.0.0.1]) by spammie.svbug.com (8.9.3/8.9.3) with ESMTP id FAA16969; Sat, 13 Jan 2001 05:40:52 -0800 (PST) (envelope-from jessem@spammie.svbug.com) Message-Id: <200101131340.FAA16969@spammie.svbug.com> Date: Sat, 13 Jan 2001 05:40:50 -0800 (PST) From: opentrax@email.com Reply-To: opentrax@email.com Subject: Re: Documentation logic error. To: arctor002@hotmail.com Cc: freebsd-doc@FreeBSD.ORG In-Reply-To: <3A5ED762.68C5A512@hotmail.com> MIME-Version: 1.0 Content-Type: TEXT/plain; charset=us-ascii Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On 12 Jan, arctor wrote: > Take a look at: > > ftp://ftp.FreeBSD.org/pub/FreeBSD/releases/i386/4.2-RELEASE/floppies/README.TXT > > ....where it says... > > "do something like this: > > C> fdimage kern.flp a: > > Assuming that you'd copied fdimage.exe and kern.flp into a directory > somewhere." > > Here's the problem: these instructions don't make literal sense. > Literally, strictly speaking, these instructions WON'T EVEN WORK. > Instead of asking the user to "copy the the files into a directory > somewhere", why not tell the user to issue the command from a DOS prompt > that is in the same directory as the fdimage utility? (Which is what the > writer was trying to say, anyway.) I know it sounds obvious, but it's > one of those things that's obvious to someone who already knows how to > do it, not to the poor newbie who's valiantly trying to learn by doing. > I follow your logic, but BSD is not for the faint of heart. If you believe that you have some better way of stating what needs to be done, the best option is to write it up and submit it for inclusion. Or write it up and post it on a webpage, then submit a PR so someone can review it. To send a PR go to: http://www.freebsd.org/send-pr.html If you are very ambitious, the read: http://www.freebsd.org/docproj/ Jessem. To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message