diff options
| author | Paul Eggert <eggert@cs.ucla.edu> | 2004-09-03 08:00:48 +0000 |
|---|---|---|
| committer | Paul Eggert <eggert@cs.ucla.edu> | 2004-09-03 08:00:48 +0000 |
| commit | 6c75cc51ea7e184607af33ad7b78971561ce743a (patch) | |
| tree | fde888f5b3a8bb0204d78b73654b11a686e8768e /doc | |
| parent | 299fd052511a4ee7fe08a0fe0488876ab108a033 (diff) | |
| download | coreutils-6c75cc51ea7e184607af33ad7b78971561ce743a.tar.xz | |
(dd invocation): Specify which conversion options
are mutually exclusive. Give a bit more detail about ascii,
ebcdic, and ibm conversions.
Diffstat (limited to 'doc')
| -rw-r--r-- | doc/coreutils.texi | 19 |
1 files changed, 17 insertions, 2 deletions
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 |