From nobody@www.freebsd.org  Mon Jun 10 05:17:22 2002
Return-Path: <nobody@www.freebsd.org>
Received: from nwww.freebsd.org (www.FreeBSD.org [216.136.204.117])
	by hub.freebsd.org (Postfix) with ESMTP id 9B09F37B406
	for <freebsd-gnats-submit@FreeBSD.org>; Mon, 10 Jun 2002 05:17:21 -0700 (PDT)
Received: from www.freebsd.org (localhost [127.0.0.1])
	by nwww.freebsd.org (8.12.2/8.12.2) with ESMTP id g5ACHLhG072342
	for <freebsd-gnats-submit@FreeBSD.org>; Mon, 10 Jun 2002 05:17:21 -0700 (PDT)
	(envelope-from nobody@www.freebsd.org)
Received: (from nobody@localhost)
	by www.freebsd.org (8.12.2/8.12.2/Submit) id g5ACHLC4072341;
	Mon, 10 Jun 2002 05:17:21 -0700 (PDT)
Message-Id: <200206101217.g5ACHLC4072341@www.freebsd.org>
Date: Mon, 10 Jun 2002 05:17:21 -0700 (PDT)
From: Dirk Gouders <gouders@et.bocholt.fh-ge.de>
To: freebsd-gnats-submit@FreeBSD.org
Subject: Misplaced parenthesis in the FAQ?
X-Send-Pr-Version: www-1.0

>Number:         39101
>Category:       docs
>Synopsis:       Misplaced parenthesis in the FAQ?
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    ceri
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Mon Jun 10 05:20:01 PDT 2002
>Closed-Date:    Mon Sep 30 12:31:59 PDT 2002
>Last-Modified:  Mon Sep 30 12:31:59 PDT 2002
>Originator:     Dirk Gouders
>Release:        4.5-RELEASE
>Organization:
FH Gelsenkirchen, Abt. Bocholt
>Environment:
FreeBSD musashi 4.5-RELEASE FreeBSD 4.5-RELEASE #11: Sat Feb 23 00:51:59 CET 2002     root@musashi:/usr/src/sys/compile/MUSASHI  i386

>Description:

>How-To-Repeat:

>Fix:
Here is a diff:

*** book.sgml	2002/05/30 21:11:55	1.445
--- book.sgml	2002/06/10 12:11:11
***************
*** 2023,2029 ****
              exist).</para>
  
            <para>The maximum size of a single ffs file is approximately 1G
!             blocks (4TB) if the block size is 4K.</para>
  
            <table>
              <title>Maximum file sizes</title>
--- 2023,2029 ----
              exist).</para>
  
            <para>The maximum size of a single ffs file is approximately 1G
!             blocks (4TB if the block size is 4K).</para>
  
            <table>
              <title>Maximum file sizes</title>

>Release-Note:
>Audit-Trail:

From: Giorgos Keramidas <keramida@FreeBSD.org>
To: Dirk Gouders <gouders@et.bocholt.fh-ge.de>
Cc: bug-followup@FreeBSD.org
Subject: Re: docs/39101: Misplaced parenthesis in the FAQ?
Date: Wed, 12 Jun 2002 02:58:23 +0300

 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
 

From: Ceri Davies <setantae@submonkey.net>
To: Giorgos Keramidas <keramida@FreeBSD.org>
Cc: freebsd-gnats-submit@FreeBSD.org
Subject: Re: docs/39101: Misplaced parenthesis in the FAQ?
Date: Wed, 12 Jun 2002 08:31:13 +0100

 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

From: Dirk GOUDERS <gouders@et.bocholt.fh-ge.de>
To: Giorgos Keramidas <keramida@FreeBSD.org>
Cc: hank@musashi.et.bocholt.fh-ge.de, bug-followup@FreeBSD.org
Subject: Re: docs/39101: Misplaced parenthesis in the FAQ? 
Date: Wed, 12 Jun 2002 10:09:19 +0200

 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

From: Giorgos Keramidas <keramida@FreeBSD.org>
To: Ceri Davies <ceri@FreeBSD.org>, bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/39101: Misplaced parenthesis in the FAQ?
Date: Wed, 12 Jun 2002 18:50:10 +0300

 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
 

From: Ceri Davies <setantae@submonkey.net>
To: Giorgos Keramidas <keramida@FreeBSD.org>
Cc: freebsd-gnats-submit@FreeBSD.org
Subject: Re: docs/39101: Misplaced parenthesis in the FAQ?
Date: Thu, 13 Jun 2002 14:06:23 +0100

 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
Responsible-Changed-From-To: freebsd-doc->ceri 
Responsible-Changed-By: ceri 
Responsible-Changed-When: Mon Sep 30 11:38:50 PDT 2002 
Responsible-Changed-Why:  
I seem to have scared everybody else away from this PR. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=39101 
State-Changed-From-To: open->closed 
State-Changed-By: ceri 
State-Changed-When: Mon Sep 30 12:31:12 PDT 2002 
State-Changed-Why:  
I committed a patch slightly closer in spirit to your original patch. 
Thanks for your submission. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=39101 
>Unformatted:
