Implement -f option: commands from file.

1 files changed, 23 insertions, 0 deletions

diff --git a/pw.1 b/pw.1
index fcb4709..6785564 100644
--- a/pw.1
+++ b/pw.1
@@ -856,6 +856,29 @@ sets a head-referenced trigger for the pattern
 .B ^Failed
 matching against line 3 of the FIFO.
 
+.IP "\fB-f\fP \fIfile\fP"
+Read colon and trigger commands from
+.I file
+and execute them.
+
+Each line of
+.I file
+must contain either a command in the same form as the argument of the
+.B -e
+option, or else a comment indicated by the first character being
+.B #
+(hash).
+
+If any line is diagnosed as erroneous, a diagnostic is issued
+and execution continues. In this case,
+.I pw
+will terminate unsuccessfully after
+.I file
+is read.
+
+Command lines with leading whitespace are invalid, and trailing whitespace
+counts as a command character (for example, as a constituent of a pattern),
+
 .SH ENVIRONMENT
 
 .I pw