Subject: RE: Using unixfs to transfer sets, extracts from new instatllati
To: RiscBSD Mailing List <port-arm32@NetBSD.ORG>
From: Olly Betts <olly@muscat.co.uk>
List: port-arm32
Date: 02/03/1997 11:16:15
Kjetil B. Thomassen wrote:
>
>(C) 1997, The RiscBSD Documentation Project.

A fairly minor point, but you really need a proper copyright
symbol or the word "Copyright" (or some particular abbreviation
of it I think).  "(C)" is widely regarded as not being good
enough, though I don't think it's ever been tested in court.
Summary: for safety, write out "Copyright" explicitly in
ASCII documents.

>3.  Preparing Your Hard Disc(s)
>
>In the following, the following terms are used:
>drive          A physical harddisc that can contain many
>logical discs (partitions)
>disc           A partition on a physical drive.
>filesystem     The RiscBSD term for a partition

Defining your terms is a good idea, but in the next paragraph:

>It is still recommended that if you decide to dedicate a disc to
>RiscBSD that you set aside a small RISC OS partition at the
>beginning of the disc.

Now here you talk about creating a partition at the beginning
of the "disc", which you've told us you're using to mean
"partition".  There are a few more examples in the rest of the
extract.  It might be better to avoid the overloaded term
"disc" entirely and use "partition" and "drive".

This may seem to be just nit-picking, but woolly use of
terminology can be most confusing if you don't have much
understanding of the subject (which is presumably true of
many readers of this document).

Actually, while I'm nit-picking, a filesystem is really the
format on a partition, rather than another term for the
partition itself.

Olly