xargs: mention in --help that -I splits input at newlines

* xargs/xargs.c (usage): Amend the -I description to mention that
the input is split at newlines.
* NEWS: Mention the change.

Fixes https://savannah.gnu.org/bugs/?58149

2 files changed, 5 insertions, 2 deletions

diff --git a/NEWS b/NEWS
index 206bc5a3..cc74ef10 100644
--- a/NEWS
+++ b/NEWS
@@ -30,6 +30,9 @@ including the call arguments and the exit code of the launched process.
 
 #58205: find.1: clarify double dash '--' option
 
+#58149: 'xargs --help' now mentions that --replace (-I, -i) splits the input
+        at newline characters.
+
 #57025: doc: enhance description of tests accepting numeric arguments in find.1
 
 #54730: Add additional valuable example of find -quit
diff --git a/xargs/xargs.c b/xargs/xargs.c
index 0dd45af1..64066d38 100644
--- a/xargs/xargs.c
+++ b/xargs/xargs.c
@@ -1683,8 +1683,8 @@ usage (int status)
          "                                 otherwise, there is no end-of-file string\n"));
   HTL (_("  -I R                         same as --replace=R\n"));
   HTL (_("  -i, --replace[=R]            replace R in INITIAL-ARGS with names read\n"
-         "                                 from standard input; if R is unspecified,\n"
-         "                                 assume {}\n"));
+         "                                 from standard input, split at newlines;\n"
+         "                                 if R is unspecified, assume {}\n"));
   HTL (_("  -L, --max-lines=MAX-LINES    use at most MAX-LINES non-blank input lines per\n"
          "                                 command line\n"));
   HTL (_("  -l[MAX-LINES]                similar to -L but defaults to at most one non-\n"