From sue@vedanix.welearn.com.au Tue Feb 16 17:02:02 1999
Return-Path: <sue@vedanix.welearn.com.au>
Received: from vedanix.welearn.com.au (vedanix.welearn.com.au [203.35.200.140])
	by hub.freebsd.org (Postfix) with ESMTP id D4BB811020
	for <FreeBSD-gnats-submit@freebsd.org>; Tue, 16 Feb 1999 17:01:53 -0800 (PST)
	(envelope-from sue@vedanix.welearn.com.au)
Received: (from sue@localhost)
	by vedanix.welearn.com.au (8.8.8/8.8.8) id MAA22404;
	Wed, 17 Feb 1999 12:10:46 +1100 (EST)
	(envelope-from sue)
Message-Id: <199902170110.MAA22404@vedanix.welearn.com.au>
Date: Wed, 17 Feb 1999 12:10:46 +1100 (EST)
From: sue@welearn.com.au
Sender: sue@vedanix.welearn.com.au
Reply-To: sue@welearn.com.au
To: FreeBSD-gnats-submit@freebsd.org
Subject: document forward(1) more fully
X-Send-Pr-Version: 3.2

>Number:         10126
>Category:       docs
>Synopsis:       document forward(1) more fully
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Tue Feb 16 17:10:00 PST 1999
>Closed-Date:    Tue Feb 16 19:38:23 PST 1999
>Last-Modified:  Tue Feb 16 19:40:20 PST 1999
>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:
State-Changed-From-To: open->closed 
State-Changed-By: jkoshy 
State-Changed-When: Tue Feb 16 19:38:23 PST 1999 
State-Changed-Why:  
Patch committed to rev 1.3 of "src/share/man/man5/forward.5", thanks! 
>Unformatted:
