From owner-freebsd-doc@FreeBSD.ORG Fri Mar 29 13:20:03 2013 Return-Path: Delivered-To: freebsd-doc@smarthost.ysv.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) by hub.freebsd.org (Postfix) with ESMTP id 70E1094E for ; Fri, 29 Mar 2013 13:20:03 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:1900:2254:206c::16:87]) by mx1.freebsd.org (Postfix) with ESMTP id 54C122C3 for ; Fri, 29 Mar 2013 13:20:03 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.6/8.14.6) with ESMTP id r2TDK2Uu052525 for ; Fri, 29 Mar 2013 13:20:02 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.6/8.14.6/Submit) id r2TDK2cf052524; Fri, 29 Mar 2013 13:20:02 GMT (envelope-from gnats) Date: Fri, 29 Mar 2013 13:20:02 GMT Message-Id: <201303291320.r2TDK2cf052524@freefall.freebsd.org> To: freebsd-doc@FreeBSD.org Cc: From: Peter Pentchev Subject: Re: docs/177429: dd(1) man page is unclear about semantics of conv=sync X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list Reply-To: Peter Pentchev List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 29 Mar 2013 13:20:03 -0000 The following reply was made to PR docs/177429; it has been noted by GNATS. From: Peter Pentchev To: "Ronald F.Guilmette" Cc: bug-followup@FreeBSD.org Subject: Re: docs/177429: dd(1) man page is unclear about semantics of conv=sync Date: Fri, 29 Mar 2013 15:18:35 +0200 --OXfL5xGRrasGEqWY Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On Wed, Mar 27, 2013 at 08:21:11PM -0700, Ronald F.Guilmette wrote: >=20 > >Number: 177429 > >Category: docs > >Synopsis: dd(1) man page is unclear about semantics of conv=3Dsync [snip] > >Description: >=20 > The man page for dd(1) describes the "sync" parameter of the "conv=3D" op= tion > thusly: >=20 > sync Pad every input block to the input buffer size. S= paces > are used for pad bytes if a block oriented convers= ion > value is specified, otherwise NUL bytes are used. >=20 > This verbage is entirely unclear. What is a "block oriented conversion va= lue" > and how would a user know whether or not he had specified one? >=20 > The man page should make this more clear & explicit. Well, the "conversion value" is the set of all parameters that you have supplied to "conv" - you can supply more than one using commas. And I think that "block-oriented" should mean that some of the things that you have specified say that the output should be in blocks - either that it is in blocks by default (and you have *not* requested unblocking it by using "ascii", "oldascii" or "unblock"), or that you've requested that dd(1) make it into blocks using one of the "block", "ebcdic", "ibm", "oldebcdic" and "oldibm" conversion specifiers. Of course, I could be wrong, but that's how I myself understand the manual page. G'luck, Peter --=20 Peter Pentchev roam@ringlet.net roam@FreeBSD.org p.penchev@storpool.com PGP key: http://people.FreeBSD.org/~roam/roam.key.asc Key fingerprint 2EE7 A7A5 17FC 124C F115 C354 651E EFB0 2527 DF13 No language can express every thought unambiguously, least of all this one. --OXfL5xGRrasGEqWY Content-Type: application/pgp-signature; name="signature.asc" Content-Description: Digital signature -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.4.12 (GNU/Linux) iQIcBAEBCAAGBQJRVZSnAAoJEGUe77AlJ98TpmEP/RrJ4OU7UR2dGVPUaytgBHEi TChwd7dyi6p49CRhdlnnnDSEnLqHzhE5KQN1did21fIPSX5uTVaca3J21quKL9hG 6bU86vgrDNS4BD71AH1r5cpx/+6gncGYuy0ic/qo0MlbozasSzfzE7pVp7DTFko7 LgWeBTUHw6tdDKxul9kP5uiRMBYdT95zSGDoltRx2rdtY9JtBpwyFbnZtXmccxFM QsnCt922G80pqL6gVpLwx0kUMa7L9MWQGGVUPydg8ExH/WZb3AfwZgFlykqahJHQ 6t+q9BOt668Jca+CsWrbJ0V5DNo5cUf7p6kvA+YdduBe2+g/N9EZu+veMwVK7xQe b3BmdnUY2beQ/ZbbW1Kw/6sbevBuHkXNlIP2DTVDDQVuhyFaEYt5t00bXjER1PXD XoTJwkNdVB7cnpdRsmGPK2Iy1b+Yul6yxBymMRybzUTBB64JIivd+wLnLOKhgXQ1 Zx/zd8vnm8DPZz3vNQK1sWqt5d95k5yLk/hFqZ+5ZhMJ6zd0FmnazPiNEPRk9wFt ooKimDTsAYaw4UyFMjPSDy5sAqh6JnO8MzWmuUjd9p0kvDhhYhHBWrv9ZvI7qqQi +ScXn3fhFztMVyG0FuxJVf/xRkHJ46CEHVpXmHHdIN4syncN8pn6TYcLm8U0qgO8 7eOt/UVjlza4uiVUkg+J =m9Qy -----END PGP SIGNATURE----- --OXfL5xGRrasGEqWY--