a forward file man page, promissed quite a while ago

2 files changed, 70 insertions, 2 deletions

diff --git a/share/man/man5/Makefile b/share/man/man5/Makefile
index 89e4f8ad042..2efcad672c9 100644
--- a/share/man/man5/Makefile
+++ b/share/man/man5/Makefile
@@ -1,4 +1,4 @@
-#	$OpenBSD: Makefile,v 1.22 2001/08/24 19:19:46 mickey Exp $
+#	$OpenBSD: Makefile,v 1.23 2001/09/11 01:06:58 marc Exp $
 #	$NetBSD: Makefile,v 1.14 1995/05/11 23:13:15 cgd Exp $
 
 # missing: dump.5 plot.5
@@ -8,7 +8,7 @@ MAN=	a.out.5 acct.5 bsd.port.mk.5 core.5 dir.5 disktab.5 ethers.5 fbtab.5 \
 	link.5 login.conf.5 moduli.5 motd.5 netgroup.5 networks.5 passwd.5 \
 	passwd.conf.5 nat.conf.5 pf.conf.5 phones.5 printcap.5 protocols.5 \
 	remote.5 resolv.conf.5 rpc.5 services.5 shells.5 stab.5 sysctl.conf.5 \
-	types.5 utmp.5 wsconsctl.conf.5
+	types.5 utmp.5 wsconsctl.conf.5 forward.5
 MLINKS= dir.5 dirent.5 fs.5 inode.5 utmp.5 wtmp.5 utmp.5 lastlog.5
 MLINKS+= hosts.equiv.5 .rhosts.5
 MLINKS+= resolv.conf.5 resolver.5
diff --git a/share/man/man5/forward.5 b/share/man/man5/forward.5
new file mode 100644
index 00000000000..1d524b135a3
--- /dev/null
+++ b/share/man/man5/forward.5
@@ -0,0 +1,68 @@
+.\"	$OpenBSD: forward.5,v 1.1 2001/09/11 01:06:58 marc Exp $
+.\"
+.\"	Copyright (c) 2001 Marco S. Hyman
+.\"
+.\"	Permission to copy all or part of this material with or without
+.\"	modification for any purpose is granted provided that the above
+.\"	copyright notice and this paragraph are duplicated in all copies.
+.\"
+.\"	THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR
+.\"	IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED
+.\"	WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
+.\"
+.Dd August 1, 2001
+.Dt FORWARD 5
+.Os
+.Sh NAME
+.Nm .forward
+.Nd e-mail forwarding information file
+.Sh DESCRIPTION
+Users may put a file named
+.Pa .forward
+in their home directory.  If this file exists,
+.Nm sendmail
+(and sendmail-like mailers) will redirect mail for the user to the list of
+addresses found in the
+.Pa .forward
+file.
+.Pa .forward
+files must not be group or world writable.  The users 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:
+.Pp
+.Bd -literal -offset indent -compact
+# 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
+"| /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
+.Rs
+.%T "Sendmail \- An Internetwork Mail Router"
+.%V SMM
+.%N \&No. 9 
+.Re
+.Rs
+.%T "Sendmail Installation and Operation Guide"
+.%V SMM
+.%N \&No. 8
+.Re
+.Pp
+http://www.sendmail.org/
+
+