From 5242a99f8a0d084dbfad82eca6a144e0fb42a33b Mon Sep 17 00:00:00 2001
From: jmc <jmc@openbsd.org>
Date: Wed, 27 Aug 2008 20:39:32 +0000
Subject: [PATCH] document \user; from Kristaps D?onsons, originally from
 Mengzhu Wang document comma separated entries; from millert reorganise the
 page a bit to read better

ok millert
---
 share/man/man5/forward.5 | 36 +++++++++++++++++++++---------------
 1 file changed, 21 insertions(+), 15 deletions(-)

diff --git a/share/man/man5/forward.5 b/share/man/man5/forward.5
index 93d4d126dd2..bca9858180d 100644
--- a/share/man/man5/forward.5
+++ b/share/man/man5/forward.5
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: forward.5,v 1.7 2007/05/31 19:19:58 jmc Exp $
+.\"	$OpenBSD: forward.5,v 1.8 2008/08/27 20:39:32 jmc Exp $
 .\"
 .\"	Copyright (c) 2001 Marco S. Hyman
 .\"
@@ -10,7 +10,7 @@
 .\"	IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED
 .\"	WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
 .\"
-.Dd $Mdocdate: May 31 2007 $
+.Dd $Mdocdate: August 27 2008 $
 .Dt FORWARD 5
 .Os
 .Sh NAME
@@ -26,32 +26,38 @@ If this file exists,
 addresses found in the
 .Pa .forward
 file.
-.Pa .forward
-files must not be group or world writable.
-The user's home directory should not be group writable.
-The
-.Pa .forward
-file must be owned by and readable by the indicated user.
 .Pp
 A
 .Pa .forward
 file contains one or more lines where each line is an e-mail address
 or the name of a private incoming mailer where incoming mail will be
 forwarded.
-Examples:
+Multiple entries may be specified on one line, comma separated.
+Additionally, a copy of all mail may be retained
+on the local machine using a
+.Dq \euser
+entry.
+.Pp
+.Pa .forward
+files must not be group or world writable.
+The user's home directory should not be group writable.
+The
+.Pa .forward
+file must be owned by and readable by the indicated user.
+.Sh FILES
+.Bl -tag -width $HOME/.forward -compact
+.It Pa $HOME/.forward
+e-mail forwarding information
+.El
+.Sh EXAMPLES
 .Bd -literal -offset indent
 # lines with # in the first column are ignored
 # empty lines are ignored
 # #@# with whitespace on both sides may be used to start a comment
 
-foo@bar.baz.com				#@# is a comment anywhere
+foo@bar.baz.com, \euser			#@# is a comment anywhere
 "| /usr/local/libexec/slocal -user foo"
 .Ed
-.Sh FILES
-.Bl -tag -width $HOME/.forward -compact
-.It Pa $HOME/.forward
-e-mail forwarding information
-.El
 .Sh SEE ALSO
 .Xr aliases 5 ,
 .Xr sendmail 8
-- 
2.20.1