[bug #29698] Correct and clarify documentation of xargs -d option

[Jon Jensen]

Follow-up Comment #3, bug #29698 (project findutils):

I see what you're saying now about the input vs. the -d argument. The way the
help reads, I thought it was saying there's nothing special about a backslash
in the -d argument, which isn't true, because of C backslash escapes.

So I don't think the help is wrong, but it was unclear to me. I would find it
clearer if it were reordered to group all notes about the specified character
together, followed by all notes about the input text, followed by other
notes.

Input items are terminated by the specified character. The specified
delimiter may be a single character, a C-style character escape such as n, or
an octal or hexadecimal escape code. Multibyte characters are not supported.
Any extra characters beyond the first one are ignored. Note that you likely
need to quote backslashes for your shell, for example n as 'n'. 

Every character in the input is taken literally; quotes and backslash are not
special there.

Disables the end-of-file string, which is treated like any other argument. 
This can be used when the input consists of simply newline-separated items,
although it is almost always better to design your program to use --null where
this is possible.

    _______________________________________________________

Reply to this item at:

  <http://savannah.gnu.org/bugs/?29698>

_______________________________________________
  Message sent via/by Savannah
  http://savannah.gnu.org/