From deb3ed0a579dadbd6cca7ef2e7fb10148387a1ca Mon Sep 17 00:00:00 2001
From: Karen Arutyunov <karen@codesynthesis.com>
Date: Thu, 9 Mar 2017 15:42:32 +0300
Subject: Add support for in place editing for sed builtin

---
 doc/testscript.cli | 13 +++++++++----
 1 file changed, 9 insertions(+), 4 deletions(-)

(limited to 'doc/testscript.cli')

diff --git a/doc/testscript.cli b/doc/testscript.cli
index 4c46786..078f674 100644
--- a/doc/testscript.cli
+++ b/doc/testscript.cli
@@ -2392,12 +2392,14 @@ working directory unless the \c{-f} option is specified.
 \h#builtins-sed|\c{sed}|
 
 \
-sed [-n] -e <script> [<file>]
+sed [-n] [-i] -e <script> [<file>]
 \
 
 Read text from \i{file}, make editing changes according to \i{script}, and
 write the result to \c{stdout}. If \i{file} is not specified or is \c{-}, read
-from \c{stdin}.
+from \c{stdin}. If both \i{file} and the \c{-i} option are specified then edit
+the \i{file} in place. Specifying \c{-i} when reading from \c{stdin} is
+illegal.
 
 Note that this builtin implementation deviates significantly from POSIX
 \c{sed} (as described next). Most significantly, the regular expression flavor
@@ -2410,6 +2412,10 @@ is ECMAScript (more specifically, ECMA-262-based C++11 regular expressions).
   Suppress automatic printing of the pattern space at the end of the script
   execution.|
 
+\li|\n\c{-i}
+
+  Edit \i{file} in place.|
+
 \li|\n\c{-e <script>}\n
 
   Editing commands to be executed (required).||
@@ -2417,8 +2423,7 @@ is ECMAScript (more specifically, ECMA-262-based C++11 regular expressions).
 To perform the transformation \c{sed} reads each line of input (without the
 newline) into the pattern space. It then executes the script commands on the
 pattern space. At the end of the script execution, unless the \c{-n} option is
-specified, \c{sed} writes the pattern space to \c{stdout} followed by a
-newline.
+specified, \c{sed} writes the pattern space to output followed by a newline.
 
 Currently, only single-command scripts using the following editing commands
 are supported.
-- 
cgit v1.1