mailaddr(7): wave goodbye
authorEitan Adler <lists@eitanadler.com>
Sat, 11 Nov 2017 07:03:06 +0000 (23:03 -0800)
committerEitan Adler <lists@eitanadler.com>
Sat, 11 Nov 2017 07:04:57 +0000 (23:04 -0800)
The information here is somewhere between ancient to obsolete.
It refers to a time in the internet's history when manual routing
was still useful, talks about UUCP as if its modern, and refers
to documents which I had trouble tracking down.

It seems unlikely that a manual page in this form would be useful, so
just remove it.

Also committed in: FreeBSD r325702

libexec/dma/dma.8
share/man/man5/forward.5
share/man/man7/Makefile
share/man/man7/hostname.7
share/man/man7/mailaddr.7 [deleted file]
usr.bin/mail/mail.1

index 1b83597..c02ebcf 100644 (file)
@@ -332,7 +332,6 @@ This value will be overridden when the
 flag is used.
 .El
 .Sh SEE ALSO
-.Xr mailaddr 7 ,
 .Xr mailwrapper 8 ,
 .Xr sendmail 8
 .Rs
index 5a363be..06de28e 100644 (file)
@@ -90,5 +90,4 @@ The user's forwarding instructions.
 .El
 .Sh SEE ALSO
 .Xr aliases 5 ,
-.Xr mailaddr 7 ,
 .Xr sendmail 8
index 4c8fe89..bc94cf6 100644 (file)
@@ -13,7 +13,6 @@ MAN=  ascii.7 \
        hier.7 \
        hostname.7 \
        intro.7 \
-       mailaddr.7 \
        nls.7 \
        operator.7 \
        release.7 \
index ba7fd6a..339800c 100644 (file)
@@ -82,7 +82,6 @@ by a system-wide configuration file (see
 .Sh SEE ALSO
 .Xr gethostbyname 3 ,
 .Xr resolver 5 ,
-.Xr mailaddr 7 ,
 .Xr named 8
 .Sh HISTORY
 .Nm Hostname
diff --git a/share/man/man7/mailaddr.7 b/share/man/man7/mailaddr.7
deleted file mode 100644 (file)
index 4424a0c..0000000
+++ /dev/null
@@ -1,149 +0,0 @@
-.\" Copyright (c) 1983, 1987, 1990, 1993
-.\"    The Regents of the University of California.  All rights reserved.
-.\"
-.\" Redistribution and use in source and binary forms, with or without
-.\" modification, are permitted provided that the following conditions
-.\" are met:
-.\" 1. Redistributions of source code must retain the above copyright
-.\"    notice, this list of conditions and the following disclaimer.
-.\" 2. Redistributions in binary form must reproduce the above copyright
-.\"    notice, this list of conditions and the following disclaimer in the
-.\"    documentation and/or other materials provided with the distribution.
-.\" 3. Neither the name of the University nor the names of its contributors
-.\"    may be used to endorse or promote products derived from this software
-.\"    without specific prior written permission.
-.\"
-.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
-.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
-.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
-.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
-.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
-.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
-.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
-.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
-.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
-.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
-.\" SUCH DAMAGE.
-.\"
-.\"     @(#)mailaddr.7 8.1 (Berkeley) 6/16/93
-.\" $FreeBSD: src/share/man/man7/mailaddr.7,v 1.6.2.1 2001/08/17 13:08:49 ru Exp $
-.\" $DragonFly: src/share/man/man7/mailaddr.7,v 1.5 2007/11/23 23:16:37 swildner Exp $
-.\"
-.Dd June 16, 1993
-.Dt MAILADDR 7
-.Os
-.Sh NAME
-.Nm mailaddr
-.Nd mail addressing description
-.Sh DESCRIPTION
-Mail addresses are based on the Internet protocol listed at the end of this
-manual page.  These addresses are in the general format
-.Pp
-.Dl user@domain
-.Pp
-where a domain is a hierarchical dot separated list of subdomains.  For
-example, a valid address is:
-.Pp
-.Dl eric@CS.Berkeley.EDU
-.Pp
-Unlike some other forms of addressing, domains do not imply any routing.
-Thus, although this address is specified as an Internet address, it might
-travel by an alternate route if that were more convenient or efficient.
-For example, at Berkeley, the associated message would probably go directly
-to CS over the Ethernet rather than going via the Berkeley Internet
-gateway.
-.Ss Abbreviation.
-Under certain circumstances it may not be necessary to type the entire
-domain name.  In general, anything following the first dot may be omitted
-if it is the same as the domain from which you are sending the message.
-For example, a user on ``calder.berkeley.edu'' could send to ``eric@CS''
-without adding the ``berkeley.edu'' since it is the same on both sending
-and receiving hosts.
-.Ss Compatibility.
-Certain old address formats are converted to the new format to provide
-compatibility with the previous mail system.  In particular,
-.Pp
-.Dl user@host
-.Pp
-and
-.Dl user@host.domain
-.Pp
-are allowed;
-.Pp
-.Dl host.domain!user
-.Pp
-is converted to
-.Pp
-.Dl user@host.domain
-.Pp
-and
-.Pp
-.Dl host!user
-.Pp
-is converted to
-.Pp
-.Dl user@host.UUCP
-.Pp
-This is normally converted back to the ``host!user'' form before being sent
-on for compatibility with older UUCP hosts.
-.Ss Case Distinctions.
-Domain names (i.e., anything after the ``@'' sign) may be given in any mixture
-of upper and lower case with the exception of UUCP hostnames.  Most hosts
-accept any combination of case in user names, with the notable exception of
-MULTICS sites.
-.Ss Route-addrs.
-Under some circumstances it may be necessary to route a message through
-several hosts to get it to the final destination.  Normally this routing
-is done automatically, but sometimes it is desirable to route the message
-manually.  Addresses which show these relays are termed ``route-addrs.''
-These use the syntax:
-.Pp
-.Dl <@hosta,@hostb:user@hostc>
-.Pp
-This specifies that the message should be sent to hosta, from there to hostb,
-and finally to hostc.  This path is forced even if there is a more efficient
-path to hostc.
-.Pp
-Route-addrs occur frequently on return addresses, since these are generally
-augmented by the software at each host.  It is generally possible to ignore
-all but the ``user@hostc'' part of the address to determine the actual
-sender.
-.Pp
-[Note: the route-addr syntax is officially deprecated
-in RFC 1123 and should not be used.]
-.Pp
-Many sites also support the ``percent hack'' for simplistic routing:
-.Pp
-.Dl user%hostc%hostb@hosta
-.Pp
-is routed as indicated in the previous example.
-.Ss Postmaster.
-Every site is required to have a user or user alias designated ``postmaster''
-to which problems with the mail system may be addressed.
-.Ss Other Networks.
-Some other networks can be reached by giving the name of the network as the
-last component of the domain.
-.Em This is not a standard feature
-and may
-not be supported at all sites.  For example, messages to CSNET or BITNET sites
-can often be sent to ``user@host.CSNET'' or ``user@host.BITNET'' respectively.
-.Sh SEE ALSO
-.Xr mail 1 ,
-.Xr sendmail 8
-.Rs
-.%A Crocker, D. H.
-.%T Standard for the Format of Arpa Internet Text Messages
-.%O RFC 822
-.Re
-.Sh HISTORY
-.Nm Mailaddr
-appeared in
-.Bx 4.2 .
-.Sh BUGS
-The RFC 822 group syntax (``group:user1,user2,user3;'') is not supported
-except in the special case of ``group:;'' because of a conflict with old
-berknet-style addresses.
-.Pp
-Route-Address syntax is grotty.
-.Pp
-UUCP- and Internet-style addresses do not coexist politely.
index d6d0828..15795a5 100644 (file)
@@ -322,9 +322,6 @@ but any reply returned to the machine will have the system wide
 alias expanded as all mail goes through
 .Xr sendmail 8 .
 .Ss "Network Mail (ARPA, UUCP, Berknet)"
-See
-.Xr mailaddr 7
-for a description of network addresses.
 .Pp
 The
 .Nm
@@ -1233,11 +1230,7 @@ if it exists.
 .Xr newaliases 1 ,
 .Xr vacation 1 ,
 .Xr aliases 5 ,
-.Xr mailaddr 7 ,
 .Xr sendmail 8
-.Rs
-.%T "The Mail Reference Manual"
-.Re
 .Sh HISTORY
 A
 .Nm