PATCH: >& documentation

PATCH: >& documentation

[Zefram]

This patch corrects the documentation of >& to match the actual
behaviour, and adds entries to the documentation for all the related
append/clobber variants.  (Anything matching /(\&\>\>?|\>\>?\&)(\||\!|)/
is a valid stderr redirection operator.)  This should be applied on top
of Bart's 8184.

-zefram

diff -cr ../zsh-/Doc/Zsh/redirect.yo ./Doc/Zsh/redirect.yo
*** ../zsh-/Doc/Zsh/redirect.yo	Sun Oct 10 14:38:23 1999
--- ./Doc/Zsh/redirect.yo	Sun Oct 10 14:54:41 1999
***************
*** 92,102 ****
  )
  xitem(tt(>&) var(word))
  item(tt(&>) var(word))(
! Same as `tt(>) var(word) tt(2>&1)'.  Note that with tt(&>), var(word) is
! never interpreted as a file descriptor, even if it is a number.
  )
! item(tt(>>&) var(word))(
! Same as `tt(>>) var(word) tt(2>&1)'.
  )
  enditem()
  
--- 92,122 ----
  )
  xitem(tt(>&) var(word))
  item(tt(&>) var(word))(
! (Except where `tt(>&) var(word)' matches one of the above syntaxes;
! `tt(&>)' can always be used to avoid this ambiguity.)
! Redirects both standard output and standard error (file descriptor 2)
! in the manner of `tt(>) var(word)'.
! Note that this does em(not) have the same effect as `tt(>) var(word) tt(2>&1)'
! in the presence of multios (see the section below).
  )
! xitem(tt(>&|) var(word))
! xitem(tt(>&!) var(word))
! xitem(tt(&>|) var(word))
! item(tt(&>!) var(word))(
! Redirects both standard output and standard error (file descriptor 2)
! in the manner of `tt(>|) var(word)'.
! )
! xitem(tt(>>&) var(word))
! item(tt(&>>) var(word))(
! Redirects both standard output and standard error (file descriptor 2)
! in the manner of `tt(>>) var(word)'.
! )
! xitem(tt(>>&|) var(word))
! xitem(tt(>>&!) var(word))
! xitem(tt(&>>|) var(word))
! item(tt(&>>!) var(word))(
! Redirects both standard output and standard error (file descriptor 2)
! in the manner of `tt(>>|) var(word)'.
  )
  enditem()
  
END