mail: provide a way to set return address.

* mail/mail.c: New option -r (--return-address).
* mail/mailvar.c: New variable "return-address".
* mail/send.c (send_message): Obtain the return mail address
from the "return-address" variable (if set).

* NEWS: Update.
* doc/texinfo/programs.texi: Update.

1 files changed, 13 insertions, 1 deletions

diff --git a/doc/texinfo/programs.texi b/doc/texinfo/programs.texi
index aaa66f5ce..4ba978dc7 100644
--- a/doc/texinfo/programs.texi
+++ b/doc/texinfo/programs.texi
@@ -2489,7 +2489,6 @@ Do not read the system-wide mailrc file.  @xref{Mail Configuration Files}.
 Do not display initial header summary.
 @item -p
 @itemx --print
-@itemx -r
 @itemx --read
 Print all mail to standard output.  It is equivalent to issuing following
 commands after starting @samp{mail -N}:
@@ -2499,6 +2498,9 @@ print *
 quit
 @end group
 @end example
+@item -r @var{address}
+@itemx --return-address=@var{address}
+Sets the return email address for outgoing mail.  @xref{return-address}.
 @item -q
 @itemx --quit
 Cause interrupts to terminate program.
@@ -4371,6 +4373,16 @@ set replyregex="^(re|odp|aw|ang)(\\[[0-9]+\\])?:[[:blank:]]"
 @noindent
 (Notice the quoting of backslash characters).
 
+@anchor{return-address}
+@kwindex return-address
+@item return-address
+@*Type: String
+@*Default: unset
+@vrindex return-address, mail variable.
+
+Sets the return email address to use when sending messages.  If unset,
+the address is composed from the current user name and the host name.
+
 @kwindex save
 @item save
 @*Type: Boolean.