From: Paul Eggert <eggert@cs.ucla.edu>
Date: Fri, 3 Sep 2004 08:00:48 +0000 (+0000)
Subject: (dd invocation): Specify which conversion options
X-Git-Tag: COREUTILS-5_3_0~751
X-Git-Url: http://review.tizen.org/git/?a=commitdiff_plain;h=6c75cc51ea7e184607af33ad7b78971561ce743a;p=platform%2Fupstream%2Fcoreutils.git

(dd invocation): Specify which conversion options
are mutually exclusive.  Give a bit more detail about ascii,
ebcdic, and ibm conversions.
---

diff --git a/doc/coreutils.texi b/doc/coreutils.texi
index 0622f75..531298d 100644
--- a/doc/coreutils.texi
+++ b/doc/coreutils.texi
@@ -6640,15 +6640,24 @@ Conversions:
 
 @item ascii
 @opindex ascii@r{, converting to}
-Convert @acronym{EBCDIC} to @acronym{ASCII}.
+Convert @acronym{EBCDIC} to @acronym{ASCII},
+using the conversion table specified by @acronym{POSIX}.
+This provides a 1:1 translation for all 256 bytes.
 
 @item ebcdic
 @opindex ebcdic@r{, converting to}
 Convert @acronym{ASCII} to @acronym{EBCDIC}.
+This is the inverse of the @samp{ascii} conversion.
 
 @item ibm
 @opindex alternate ebcdic@r{, converting to}
-Convert @acronym{ASCII} to alternate @acronym{EBCDIC}.
+Convert @acronym{ASCII} to alternate @acronym{EBCDIC},
+using the alternate conversion table specified by @acronym{POSIX}.
+This is not a 1:1 translation, but reflects common historical practice
+for @samp{~}, @samp{[}, and @samp{]}.
+
+The @samp{ascii}, @samp{ebcdic}, and @samp{ibm} conversions are
+mutually exclusive.
 
 @item block
 @opindex block @r{(space-padding)}
@@ -6660,6 +6669,8 @@ input newline with a space and padding with spaces as necessary.
 Replace trailing spaces in each @samp{cbs}-sized input block with a
 newline.
 
+The @samp{block} and @samp{unblock} conversions are mutually exclusive.
+
 @item lcase
 @opindex lcase@r{, converting to}
 Change uppercase letters to lowercase.
@@ -6668,6 +6679,8 @@ Change uppercase letters to lowercase.
 @opindex ucase@r{, converting to}
 Change lowercase letters to uppercase.
 
+The @samp{lcase} and @samp{ucase} conversions are mutually exclusive.
+
 @item swab
 @opindex swab @r{(byte-swapping)}
 @cindex byte-swapping
@@ -6691,6 +6704,8 @@ Do not create the output file; the output file must already exist.
 Fail if the output file already exists; @command{dd} must create the
 output file itself.
 
+The @samp{excl} and @samp{nocreat} conversions are mutually exclusive.
+
 @item notrunc
 @opindex notrunc
 @cindex truncating output file, avoiding