From 8d67429c8b37415b04ec195dab9bdbcec8ec013a Mon Sep 17 00:00:00 2001
From: Laurent Bercot <ska-skaware@skarnet.org>
Date: Tue, 24 Nov 2020 10:44:08 +0000
Subject:  Make forstdin only split on newlines by default

---
 doc/forstdin.html | 6 ++++--
 doc/upgrade.html  | 3 ++-
 2 files changed, 6 insertions(+), 3 deletions(-)

(limited to 'doc')

diff --git a/doc/forstdin.html b/doc/forstdin.html
index f57ee9c..c7cc3d4 100644
--- a/doc/forstdin.html
+++ b/doc/forstdin.html
@@ -35,7 +35,7 @@ run another program.
 
 <ul>
  <li> <tt>forstdin</tt> reads its standard input as it becomes available,
-<a href="el_transform.html#split">splitting</a> it automatically. </li>
+<a href="el_transform.html#split">splitting</a> it on every line automatically. </li>
  <li> For every argument <em>x</em> in the split output,
 <tt>forstdin</tt> runs <em>loop...</em> as a child process, with
 <em>variable</em>=<em>x</em> added to its environment. </li>
@@ -67,7 +67,9 @@ codes will make it keep looping. </li>
 exit <em>eofcode</em>. Default is 0. </li>
  <li> Other options are used to <a href="el_transform.html">control
 the substitution mechanism</a> for every <em>x</em>. Of course, you can't
-split <em>x</em>. </li>
+split <em>x</em>. The default delimiter for <tt>forstdin</tt> is a
+newline; you need a <tt>-d</tt> option to split <em>x</em> around
+other values. </li>
 </ul>
 
 <h2> Notes </h2>
diff --git a/doc/upgrade.html b/doc/upgrade.html
index aa23ab2..690c87e 100644
--- a/doc/upgrade.html
+++ b/doc/upgrade.html
@@ -23,7 +23,8 @@
 <ul>
  <li> <a href="//skarnet.org/software/skalibs/">skalibs</a>
 dependency bumped to 2.9.4.0. </li>
- <li> New <tt>-e</tt> option to <a href="forstdin.html">forstdin</a>. </li>
+ <li> <a href="forstdin.html">forstdin</a> gets a new <tt>-e</tt>
+option, and now only splits on newlines by default.  </li>
  <li> New <tt>default</tt> directive to <a href="trap.html">trap</a>,
 replacing the <tt>timeout</tt> one, which was ill-suited to that program. </li>
 </ul>
-- 
cgit v1.3.1