Suggested change to tee manpage to show usefulness
From:
Don Kitchen
Subject:
Suggested change to tee manpage to show usefulness
Date:
Sun, 27 Aug 2006 21:45:26 -0700 (PDT)
--- tee.1 2005-06-06 00:11:04.000000000 -0700
+++ tee.1.new 2005-06-06 00:09:16.000000000 -0700
@@ -8,7 +8,7 @@
.SH DESCRIPTION
.\" Add any additional description here
.PP
-Copy standard input to each FILE, and also to standard output.
+Copy standard input to each FILE, and also to standard output. Since there is
only one standard out, it can only be piped to one program. However, tee can
send output to a "file" that is a fifo, which can then be read by some other
program.
.TP
\fB\-a\fR, \fB\-\-append\fR
append to the given FILEs, do not overwrite
@@ -42,3 +42,11 @@
.B info coreutils tee
.PP
should give you access to the complete manual.
+.SH EXAMPLES
+cat file1 | sort | tee file1.sorted | uniq > file1.uniq
+.PP
+mkfifo fifo
+.br
+cat fifo | uniq > file1.uniq &
+.br
+cat file1 | sort | tee file.sorted fifo | grep text > file1.grep