From 6c75cc51ea7e184607af33ad7b78971561ce743a Mon Sep 17 00:00:00 2001 From: Paul Eggert Date: Fri, 3 Sep 2004 08:00:48 +0000 Subject: (dd invocation): Specify which conversion options are mutually exclusive. Give a bit more detail about ascii, ebcdic, and ibm conversions. --- doc/coreutils.texi | 19 +++++++++++++++++-- 1 file changed, 17 insertions(+), 2 deletions(-) (limited to 'doc') diff --git a/doc/coreutils.texi b/doc/coreutils.texi index 0622f7566..531298d26 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 -- cgit v1.2.3-70-g09d2