Skip site navigation (1)Skip section navigation (2)
Date:      Sat, 13 Jan 2001 05:40:50 -0800 (PST)
From:      opentrax@email.com
To:        arctor002@hotmail.com
Cc:        freebsd-doc@FreeBSD.ORG
Subject:   Re: Documentation logic error.
Message-ID:  <200101131340.FAA16969@spammie.svbug.com>
In-Reply-To: <3A5ED762.68C5A512@hotmail.com>

next in thread | previous in thread | raw e-mail | index | archive | help


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




Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?200101131340.FAA16969>