* coreutils.texi (dd invocation): Improve the documentation

for bs, ibs, obs, and cbs.  Suggestion from Dan Jacobson.
Patch by Olivier Delhomme.

diff --git a/doc/ChangeLog b/doc/ChangeLog
index 60341abab07247eb5be6a2bf14a9ac4607d1ebb5..201070dbfd0588cdb8d051ae7c095c223e60d88c 100644 (file)
--- a/doc/ChangeLog
+++ b/doc/ChangeLog
@@ -1,3 +1,9 @@
+2006-12-21  Jim Meyering  <jim@meyering.net>
+
+       * coreutils.texi (dd invocation): Improve the documentation
+       for bs, ibs, obs, and cbs.  Suggestion from Dan Jacobson.
+       Patch by Olivier Delhomme.
+
 2006-12-14  Jim Meyering  <jim@meyering.net>
 
        * coreutils.texi: Remove two doubled words.

diff --git a/doc/coreutils.texi b/doc/coreutils.texi
index c7952facc6305524138f11483c69bff5aeb2b030..98bfadb836084a6837fcd9dda83b44f921969a7a 100644 (file)
--- a/doc/coreutils.texi
+++ b/doc/coreutils.texi
@@ -7155,25 +7155,28 @@ bytes (or the size specified with @samp{seek=}).
 @opindex ibs
 @cindex block size of input
 @cindex input block size
-Read @var{bytes} bytes at a time.
+Set the input block size to @var{bytes}.
+This makes @command{dd} read @var{bytes} per block.
 
 @item obs=@var{bytes}
 @opindex obs
 @cindex block size of output
 @cindex output block size
-Write @var{bytes} bytes at a time.
+Set the output block size to @var{bytes}.
+This makes @command{dd} write @var{bytes} per block.
 
 @item bs=@var{bytes}
 @opindex bs
 @cindex block size
-Both read and write @var{bytes} bytes at a time.  This overrides
-@samp{ibs} and @samp{obs}.
+Set both input and output block sizes to @var{bytes}.
+This makes @command{dd} read and write @var{bytes} per block,
+overriding @samp{ibs} and @samp{obs}.
 
 @item cbs=@var{bytes}
 @opindex cbs
 @cindex block size of conversion
 @cindex conversion block size
-Convert @var{bytes} bytes at a time.
+Set the conversion block size to @var{bytes}.
 
 @item skip=@var{blocks}
 @opindex skip