*: initial commit

wye is an input-oriented tee variant

The name is derived from the plumbing name for a
directional tee, or "Y" intersection.

1 files changed, 12 insertions, 0 deletions

diff --git a/README b/README
new file mode 100644
index 0000000..e57b6c3
--- /dev/null
+++ b/README
@@ -0,0 +1,12 @@
+`wye` is an input variant of the `tee` utility
+
+Usage is like `tee`: wye [FILE]...
+
+wye always consumes from its stdin, the optional files specified are
+read-multiplexed as alternative inputs to stdin.  All reads are
+performed using PIPE_BUF sized buffers which are the atomic units for
+unix pipes, any read data is immediately written to stdout.
+
+Someone should try get this command added upstream in GNU Coreutils
+upstream, and give me credit for the name.  This implementation is a
+quick and dirty hack and not particularly robust.