Bug 39101

Comment 1 Giorgos Keramidas 2002-06-12 00:58:23 UTC

On 2002-06-10 05:17 -0700, Dirk Gouders wrote:
>
> Here is a diff:
>
> *** book.sgml	2002/05/30 21:11:55	1.445
>             <para>The maximum size of a single ffs file is approximately 1G
> !             blocks (4TB) if the block size is 4K.</para>
> --- 2023,2029 ----
>             <para>The maximum size of a single ffs file is approximately 1G
> !             blocks (4TB if the block size is 4K).</para>

I think the text is unclear, that is why it confused you.  What about
this change that attempts to clarify the details a bit?

%%%
Index: book.sgml
===================================================================
RCS file: /home/ncvs/doc/en_US.ISO8859-1/books/faq/book.sgml,v
retrieving revision 1.447
diff -u -r1.447 book.sgml
--- book.sgml	11 Jun 2002 22:46:37 -0000	1.447
+++ book.sgml	11 Jun 2002 23:55:30 -0000
@@ -2026,8 +2026,8 @@
             modifications filesystems with 4 terabytes are possible (and
             exist).</para>
 
-          <para>The maximum size of a single ffs file is approximately 1G
-            blocks (4TB) if the block size is 4K.</para>
+	  <para>When the block size is 4KB, the maximum size of a single ffs
+	    file is approximately 4TB (4096 * 1GB blocks = 4TB).</para>
 
           <table>
             <title>Maximum file sizes</title>
%%%

- Giorgos

On Tue, Jun 11, 2002 at 05:00:07PM -0700, Giorgos Keramidas wrote:
>   
>  -          <para>The maximum size of a single ffs file is approximately 1G
>  -            blocks (4TB) if the block size is 4K.</para>
>  +	  <para>When the block size is 4KB, the maximum size of a single ffs
>  +	    file is approximately 4TB (4096 * 1GB blocks = 4TB).</para>

s/GB/G/

Ceri

-- 
you can't see when light's so strong
you can't see when light is gone

I noticed that in message "Re: docs/39101: Misplaced parenthesis in the FAQ?", 
Giorgos Keramidas wrote:

 > I think the text is unclear, that is why it confused you.  What about
 > this change that attempts to clarify the details a bit?
 > %%%
 > Index: book.sgml
 > ===================================================================
 > RCS file: /home/ncvs/doc/en_US.ISO8859-1/books/faq/book.sgml,v
 > retrieving revision 1.447
 > diff -u -r1.447 book.sgml
 > --- book.sgml	11 Jun 2002 22:46:37 -0000	1.447
 > +++ book.sgml	11 Jun 2002 23:55:30 -0000
 > @@ -2026,8 +2026,8 @@
 >              modifications filesystems with 4 terabytes are possible (and
 >              exist).</para>
 >  
 > -          <para>The maximum size of a single ffs file is approximately 1G
 > -            blocks (4TB) if the block size is 4K.</para>
 > +	  <para>When the block size is 4KB, the maximum size of a single ffs
 > +	    file is approximately 4TB (4096 * 1GB blocks = 4TB).</para>
 >  
 >            <table>
 >              <title>Maximum file sizes</title>
 > %%%
 > 
 > - Giorgos

That change looks good to me.  I'm not sure if it could be helpfull to
explicitely remark that the limit is made up by the number of blocks,
though.

Dirk

Comment 4 Giorgos Keramidas 2002-06-12 16:50:10 UTC

On 2002-06-12 08:31 +0100, Ceri Davies wrote:
> On Tue, Jun 11, 2002 at 05:00:07PM -0700, Giorgos Keramidas wrote:
> >   
> >  -          <para>The maximum size of a single ffs file is approximately 1G
> >  -            blocks (4TB) if the block size is 4K.</para>
> >  +	  <para>When the block size is 4KB, the maximum size of a single ffs
> >  +	    file is approximately 4TB (4096 * 1GB blocks = 4TB).</para>
> 
> s/GB/G/

Right.  This way it will match the style of the rest of this
particular question/answer ;)

Thanks.

- Giorgos

On Wed, Jun 12, 2002 at 10:30:03AM -0700, Giorgos Keramidas wrote:
>  On 2002-06-12 08:31 +0100, Ceri Davies wrote:
>  > On Tue, Jun 11, 2002 at 05:00:07PM -0700, Giorgos Keramidas wrote:
>  > >   
>  > >  -          <para>The maximum size of a single ffs file is approximately 1G
>  > >  -            blocks (4TB) if the block size is 4K.</para>
>  > >  +	  <para>When the block size is 4KB, the maximum size of a single ffs
>  > >  +	    file is approximately 4TB (4096 * 1GB blocks = 4TB).</para>
>  > 
>  > s/GB/G/
>  
>  Right.  This way it will match the style of the rest of this
>  particular question/answer ;)

Actually, I'd like to change my answer again if I may.
Not so much on style grounds, but more to do with the placement of units really.

It should actually be more like :

    4096B * 1G = 4TB

   (bytes   -    bytes)

just as in :

    4096m * 1000 = 4096km
 
   (metres  -      meters)

and :

       4096m / 10s = 40.96m/s

   (metres  seconds  metres per second)

[sheesh, what a pedant - sorry]

The proposed patch above makes it sound like the block size is 1GB !

-- 
you can't see when light's so strong
you can't see when light is gone

Comment 6 Ceri Davies 2002-09-30 19:38:50 UTC

Responsible Changed
From-To: freebsd-doc->ceri

I seem to have scared everybody else away from this PR.

Comment 7 Ceri Davies 2002-09-30 20:31:12 UTC

State Changed
From-To: open->closed

I committed a patch slightly closer in spirit to your original patch. 
Thanks for your submission.