summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--doc/coreutils.texi5
1 files changed, 4 insertions, 1 deletions
diff --git a/doc/coreutils.texi b/doc/coreutils.texi
index 61b3c8925..767267bf3 100644
--- a/doc/coreutils.texi
+++ b/doc/coreutils.texi
@@ -8167,9 +8167,12 @@ On a file system that supports sparse files, this will create
sparse output when extending the output file.
Be careful when using this option in conjunction with
@samp{conv=notrunc} or @samp{oflag=append}.
-With @samp{conv=notrunc}, existing data in the output
+With @samp{conv=notrunc}, existing data in the output file
corresponding to @sc{nul} blocks from the input, will be untouched.
With @samp{oflag=append} the seeks performed will be ineffective.
+Similarly, when the output is a device rather than a file,
+@sc{nul} input blocks are not copied, and therefore this option
+is most useful with virtual or pre zeroed devices.
@item swab
@opindex swab @r{(byte-swapping)}