Date: Wed, 17 Feb 1999 12:10:46 +1100 (EST) From: sue@welearn.com.au To: FreeBSD-gnats-submit@freebsd.org Subject: docs/10126: document forward(1) more fully Message-ID: <199902170110.MAA22404@vedanix.welearn.com.au>
next in thread | raw e-mail | index | archive | help
>Number: 10126
>Category: docs
>Synopsis: document forward(1) more fully
>Confidential: no
>Severity: non-critical
>Priority: low
>Responsible: freebsd-doc
>State: open
>Quarter:
>Keywords:
>Date-Required:
>Class: doc-bug
>Submitter-Id: current-users
>Arrival-Date: Tue Feb 16 17:10:00 PST 1999
>Closed-Date:
>Last-Modified:
>Originator: Sue Blake
>Release: FreeBSD 2.2.6-STABLE i386
>Organization:
>Environment:
>Description:
The use of the backslash is not documented here.
If the use of the backslash is documented anywhere else, it is not easy
to find.
The man page with its current example is insufficient for the common
easy task of forwarding mail while retaining a copy. An example of this
kind would help users to control their .forward files autonomously.
And while we're here, referring to aliases(5) would be a good idea.
>How-To-Repeat:
Have a user attempt to create a ~/.forward to send mail elsewhere but
retain a local copy, following this man page for the method.
>Fix:
Suggested additions:
1. Describe the use of the backslash.
2. Add an easy to follow example.
3. Add aliases(5) to "see also" for completeness.
NOTE: The man page was amended using mimicry rather than knowledge for all
those funny little codes. Please check.
--- forward.5.old Wed Feb 17 10:15:36 1999
+++ forward.5 Wed Feb 17 11:59:34 1999
@@ -67,6 +67,22 @@
.Pa /usr/bin/vacation
with the single argument
.Ar nobody .
+.Pp
+If a local user address is prefixed with a backslash
+character, mail is delivered directly to the user's
+mail spool file, bypassing further redirection.
+.Pp
+For example, if user chris had a
+.Nm .forward
+file containing the following lines:
+.Bd -literal -offset indent
+chris@otherhost
+\echris
+.Ed
+.Pp
+One copy of mail would be forwarded to
+.Ar chris@otherhost
+and another copy would be retained as mail for local user chris.
.Sh FILES
.Bl -tag -width $HOME/.forward -compact
@@ -75,5 +91,6 @@
The user's forwarding instructions.
.El
.Sh SEE ALSO
+.Xr aliases 5 ,
.Xr mailaddr 7 ,
.Xr sendmail 8
>Release-Note:
>Audit-Trail:
>Unformatted:
To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?199902170110.MAA22404>