From owner-freebsd-doc@FreeBSD.ORG  Wed May 10 20:30:24 2006
Return-Path: <owner-freebsd-doc@FreeBSD.ORG>
X-Original-To: freebsd-doc@hub.freebsd.org
Delivered-To: freebsd-doc@hub.freebsd.org
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id 5DF3E16A579
	for <freebsd-doc@hub.freebsd.org>; Wed, 10 May 2006 20:30:24 +0000 (UTC)
	(envelope-from gnats@FreeBSD.org)
Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21])
	by mx1.FreeBSD.org (Postfix) with ESMTP id E782443D48
	for <freebsd-doc@hub.freebsd.org>; Wed, 10 May 2006 20:30:23 +0000 (GMT)
	(envelope-from gnats@FreeBSD.org)
Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1])
	by freefall.freebsd.org (8.13.4/8.13.4) with ESMTP id k4AKUNQB068469
	for <freebsd-doc@freefall.freebsd.org>; Wed, 10 May 2006 20:30:23 GMT
	(envelope-from gnats@freefall.freebsd.org)
Received: (from gnats@localhost)
	by freefall.freebsd.org (8.13.4/8.13.4/Submit) id k4AKUNZR068468;
	Wed, 10 May 2006 20:30:23 GMT (envelope-from gnats)
Date: Wed, 10 May 2006 20:30:23 GMT
Message-Id: <200605102030.k4AKUNZR068468@freefall.freebsd.org>
To: freebsd-doc@FreeBSD.org
From: Coleman Kane <cokane@FreeBSD.org>
Cc: 
Subject: Re: docs/97059: pax(1): -b option description could be flawed
X-BeenThere: freebsd-doc@freebsd.org
X-Mailman-Version: 2.1.5
Precedence: list
Reply-To: Coleman Kane <cokane@FreeBSD.org>
List-Id: Documentation project <freebsd-doc.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
	<mailto:freebsd-doc-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/freebsd-doc>
List-Post: <mailto:freebsd-doc@freebsd.org>
List-Help: <mailto:freebsd-doc-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
	<mailto:freebsd-doc-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Wed, 10 May 2006 20:30:26 -0000

The following reply was made to PR docs/97059; it has been noted by GNATS.

From: Coleman Kane <cokane@FreeBSD.org>
To: Giorgos Keramidas <keramida@freebsd.org>
Cc: bug-followup@freebsd.org
Subject: Re: docs/97059: pax(1): -b option description could be flawed
Date: Thu, 11 May 2006 04:22:06 +0000

 On Wed, May 10, 2006 at 11:04:14PM +0300, Giorgos Keramidas wrote, and it was proclaimed:
 > > The pax(1) manpage states the following for the -b flag:
 > >
 > >   -b blocksize
 > >         When writing an archive, block the output at a positive
 > >         decimal integer number of bytes per write to the archive
 > >         file.  The blocksize must be a multiple of 512 bytes with
 > >         a maximum of 64512 bytes.  Archives larger than 32256
 > >         bytes violate the POSIX standard and will not be portable
 > >         to all systems.  A blocksize can end with k or b to
 > >         specify multiplication by 1024 (1K) or 512, respectively.
 > >         A pair of blocksizes can be separated by x to indicate a
 > >         product.  A specific archive device may impose additional
 > >         restrictions on the size of blocking it will support.
 > >         When blocking is not specified, the default blocksize is
 > >         dependent on the specific archive format being used (see
 > >         the -x option).
 > >
 > >   Specifically, the statement:
 > >
 > >         Archives larger than 32256 bytes violate the POSIX
 > >         standard
 > >
 > >   This could be worded better as:
 > >
 > >         Archive block sizes larger than 32256 bytes violate the
 > >         POSIX standard
 > >
 > >   This sounds more like what the author might have meant.
 > 
 > True.  Limiting the _full_ archive size to 32KB is contradictory
 > with the previous sentence about 64512 bytes, and would render
 > pax(1) pretty useless anyway.
 > 
 > Feel free to make the manpage change, or let me know and I'll do it.
 > 
 
 I'll tackle it.