aboutsummaryrefslogtreecommitdiffhomepage
path: root/doc_src/doc.hdr
diff options
context:
space:
mode:
Diffstat (limited to 'doc_src/doc.hdr')
-rw-r--r--doc_src/doc.hdr15
1 files changed, 12 insertions, 3 deletions
diff --git a/doc_src/doc.hdr b/doc_src/doc.hdr
index 7d3f58b3..9bd3e3a5 100644
--- a/doc_src/doc.hdr
+++ b/doc_src/doc.hdr
@@ -155,9 +155,7 @@ equivalent.
The user can string together multiple commands into a so called
pipeline. This means that the standard output of one command will be read
in as standard input into the next command. This is done by separating
-the commands by the pipe character (|).
-
-For example
+the commands by the pipe character (|). For example
<tt>cat foo.txt | head</tt>
@@ -169,6 +167,17 @@ to combine commands through pipes, read the manual pages of the
commands you want to use using the 'man' command. If you want to find
out more about the 'cat' program, type <tt>man cat</tt>.
+Pipes usually connect file descriptor 1 (standard output) of the first
+process to file descriptor 0 (standard input) of the second
+process. It is possible use a different output file descriptor by
+prepending it to the pipe symbol, just like you would do with normal
+IO redirections. For example:
+
+<tt>make fish 2|less</tt>
+
+will attempt to build the fish program, and any errors will be shown
+using the less pager.
+
\subsection syntax-background Background jobs
When you start a job in \c fish, \c fish itself will pause, and give