PATCH: (Doc) Re: Piping stderr (was Re: Two bug reports)

["Bart Schaefer" <schaefer@xxxxxxxxxxxxxxxx>]

On Mar 24,  7:02pm, Bart Schaefer wrote:
}
} The man page could stand improvement in this area.  Even though pipes are
} not redirections, people tend to think of them that way, and it's very
} confusing that >(...) and |& are not at least cross-referenced in the
} same section as all the redirection operators.  Even `|&' is buried in
} the middle of a boring-looking paragraph in the Shell Grammar section,
} and never metioned again.

Anybody object to this?

Index: Doc/Zsh/redirect.yo
===================================================================
diff -c -r1.2 redirect.yo
--- Doc/Zsh/redirect.yo	2001/07/10 09:05:18	1.2
+++ Doc/Zsh/redirect.yo	2002/03/24 19:45:25
@@ -138,6 +138,19 @@
 file descriptor 2 would be associated
 with the terminal (assuming file descriptor 1 had been)
 and then file descriptor 1 would be associated with file var(fname).
+
+The `tt(|&)' command separator described in
+ifzman(em(Simple Commands & Pipelines) in zmanref(zshmisc))\
+ifnzman(noderef(Simple Commands & Pipelines))
+is a shorthand for `tt(2>&1 |)'.
+
+For output redirections only, if var(word) is of the form
+`tt(>LPAR())var(list)tt(RPAR())' then the output is piped to the command
+represented by var(list).  See
+ifzman(\
+em(Process Substitution) in zmanref(zshexpn))\
+ifnzman(\
+noderef(Process Substitution)).
 sect(Multios)
 cindex(multios)
 pindex(MULTIOS, use of)


-- 
Bart Schaefer                                 Brass Lantern Enterprises
http://www.well.com/user/barts              http://www.brasslantern.com

Zsh: http://www.zsh.org | PHPerl Project: http://phperl.sourceforge.net