summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorLaurent Bercot <ska-skaware@skarnet.org>2020-11-24 10:44:08 +0000
committerLaurent Bercot <ska-skaware@skarnet.org>2020-11-24 10:44:08 +0000
commit8d67429c8b37415b04ec195dab9bdbcec8ec013a (patch)
treee42f15e902ef3d0454703e90691040c3b603042e /doc
parent79d5c4eff6101f329b8ea52dd9e6d2336ea8bc93 (diff)
downloadexecline-8d67429c8b37415b04ec195dab9bdbcec8ec013a.tar.xz
Make forstdin only split on newlines by default
Diffstat (limited to 'doc')
-rw-r--r--doc/forstdin.html6
-rw-r--r--doc/upgrade.html3
2 files changed, 6 insertions, 3 deletions
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>