review request: 2TB disk limit in disks chapter

[Simon L. Nielsen]

On 2004.09.13 13:21:07 -0700, Brooks Davis wrote:
> People are starting to build disk arrays larger then 2TB and then
> finding they can't label them.  I'd like to add some text like the
> following to the handbook section on adding disks.  A table of

Great, documenting this is very useful!

> capabilities would probably be useful and could be an intresting project
> for someone who wanted to do a little research, but I'm specificaly
> trying to address bsdlabel at this point.
> 
> Please review my changes below.

All the entities should be closed, e.g. "&man.bsdlabel.8" should be
"&man.bsdlabel.8;".

> Index: chapter.sgml
> ===================================================================
> RCS file: /home/dcvs/doc/en_US.ISO8859-1/books/handbook/disks/chapter.sgml,v
> retrieving revision 1.220
> diff -u -p -r1.220 chapter.sgml
> --- chapter.sgml	25 Aug 2004 10:33:59 -0000	1.220
> +++ chapter.sgml	13 Sep 2004 20:14:19 -0000
> @@ -202,6 +202,12 @@
>        case, the drive will be added simply as
>        <filename>/dev/da1e</filename>.</para>
>  
> +    <para>Due to the use of 32-bit integers to store the number of sectors, 

I think there is trailing whitespace on this line (unless it's just my
MUA/editor).

> +      &man.bsdlabel.8, &man.disklabel.8, &man.fdisk.8, and

Isn't disklabel just a link to the local label (bsdlabel/sunlabel
etc.) now?

> +      <application>sunlabel</application> are all limited to 2^32-1

You should also use a manual page entity for sunlabel.

> +      sectors.  This usually translates to a 2TB limit on disk size.
> +      For larger disks, &man.gpt.8 partitions may be used.</para>

Shouldn't that be "2TB limits on partition size.", since you can AFAIR?
make multiple <2TB partitions on one "disk"(/RAID)?

-- 
Simon L. Nielsen
FreeBSD Documentation Team
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 187 bytes
Desc: not available
URL: <http://lists.freebsd.org/pipermail/freebsd-doc/attachments/20040913/29562eba/attachment.sig>