From owner-freebsd-doc Fri Jan 12 0: 2:36 2001 Delivered-To: freebsd-doc@freebsd.org Received: from mta5.rcsntx.swbell.net (mta5.rcsntx.swbell.net [151.164.30.29]) by hub.freebsd.org (Postfix) with ESMTP id 8F68C37B401 for ; Fri, 12 Jan 2001 00:02:19 -0800 (PST) Received: from hotmail.com ([64.217.74.225]) by mta5.rcsntx.swbell.net (Sun Internet Mail Server sims.3.5.2000.01.05.12.18.p9) with ESMTP id <0G710089GI4K59@mta5.rcsntx.swbell.net> for freebsd-doc@FreeBSD.org; Fri, 12 Jan 2001 01:57:56 -0600 (CST) Date: Fri, 12 Jan 2001 02:07:31 -0800 From: arctor Subject: Documentation logic error. To: freebsd-doc@FreeBSD.org Reply-To: arctor002@hotmail.com Message-id: <3A5ED762.68C5A512@hotmail.com> Organization: ooga.com MIME-version: 1.0 X-Mailer: Mozilla 4.75 [en] (Win98; U) Content-type: text/plain; charset=us-ascii Content-transfer-encoding: 7bit X-Accept-Language: en Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org 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. P.S., major props to guys for writing these docs, they're a hell of a lot better than what I've dealt with at the LDP -Arctor. To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message