From 75f6926390f33f62b95b355d48bc5454243ddcea Mon Sep 17 00:00:00 2001
From: "John Ankarstr\\xf6m" <john@ankarstrom.se>
Date: Wed, 2 Jun 2021 21:12:38 +0200
Subject: Add 'each' utility

---
 each.1 | 48 ++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 48 insertions(+)
 create mode 100644 each.1

(limited to 'each.1')

diff --git a/each.1 b/each.1
new file mode 100644
index 0000000..9790be4
--- /dev/null
+++ b/each.1
@@ -0,0 +1,48 @@
+.Dd $Mdocdate$
+.Dt each 1
+.Os
+.
+.Sh NAME
+.Nm each
+.Nd do with each line
+.
+.Sh SYNOPSIS
+.Nm each
+.Ar command
+.Op Ar \\\\; command ...
+.
+.Sh DESCIPTION
+.Pp
+.Nm
+runs each given
+.Ar command
+for every line read on standard input.
+With a command, the contents of the line is assigned to the variable
+.Ev x ,
+which can be accessed with the normal shell variable interpolation syntax,
+except you need to put a plus sign after the dollar sign:
+.Bd -literal -offset indent
+$+x
+$+{x}
+$+{x#/}
+$+{x%.mp3}
+$+{x%%.*}
+.Ed
+.Pp
+This syntax generally doesn't need to be quoted
+when entered in the Bourne shell
+(unless you need to put commas inside the curly braces
+or have files who names begin with
+.Ql $+ ) .
+.Sh AUTHORS
+.Pp
+.Nm
+is written by John Ankarström
+.Aq Mt john (at) ankarstrom.se .
+.Sh BUGS
+.Pp
+It is not possible to insert a literal
+.Ql $+ .
+Quoting it with a backslash prevents the interpolation,
+but results in the literal string
+.Ql $ .
-- 
cgit v1.2.3