summaryrefslogtreecommitdiff
path: root/share/man/man7/mailaddr.7
diff options
context:
space:
mode:
authorAaron Campbell <aaron@cvs.openbsd.org>1998-11-28 03:38:03 +0000
committerAaron Campbell <aaron@cvs.openbsd.org>1998-11-28 03:38:03 +0000
commit4beb28910871edfcdf5dce787bb0f0a7a9cf17a9 (patch)
tree3417b4419d3c8a80852a1e84b4620e3deef3e883 /share/man/man7/mailaddr.7
parent9bb6028fe02a280e61b8f862f447486ce6b5f72a (diff)
share/man/man7/ man page repairs
Diffstat (limited to 'share/man/man7/mailaddr.7')
-rw-r--r--share/man/man7/mailaddr.780
1 files changed, 52 insertions, 28 deletions
diff --git a/share/man/man7/mailaddr.7 b/share/man/man7/mailaddr.7
index 86b0a9ed3fb..ad2bba6afd6 100644
--- a/share/man/man7/mailaddr.7
+++ b/share/man/man7/mailaddr.7
@@ -1,3 +1,4 @@
+.\" $OpenBSD: mailaddr.7,v 1.3 1998/11/28 03:38:02 aaron Exp $
.\" $NetBSD: mailaddr.7,v 1.3 1994/11/30 19:07:17 jtc Exp $
.\"
.\" Copyright (c) 1983, 1987, 1990, 1993
@@ -56,15 +57,19 @@ 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.
+.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
+For example, a user on
+.Dq calder.berkeley.edu
+could send to
+.Dq eric@CS
+without adding the
+.Dq berkeley.edu
+since it is the same on both sending
and receiving hosts.
-.Ss Compatibility.
-.Pp
+.Ss Compatibility
Certain old address formats are converted to the new format to provide
compatibility with the previous mail system. In particular,
.Pp
@@ -89,54 +94,69 @@ is converted to
.Pp
.Dl user@host.UUCP
.Pp
-This is normally converted back to the ``host!user'' form before being sent
+This is normally converted back to the
+.Dq host!user
+form before being sent
on for compatibility with older UUCP hosts.
.Pp
-.Ss Case Distinctions.
-.Pp
-Domain names (i.e., anything after the ``@'' sign) may be given in any mixture
+.Ss Case distinctions
+Domain names (i.e., anything after the
+.Dq @
+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.
-.Pp
+.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.''
+manually. Addresses which show these relays are termed
+.Dq 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.
+This specifies that the message should be sent to
+.Dq hosta ,
+from there to
+.Dq hostb ,
+and finally to
+.Dq hostc .
+This path is forced even if there is a more efficient
+path to
+.Dq 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.
+all but the
+.Dq user@hostc
+part of the address to determine the actual sender.
.Pp
-[Note: the route-addr syntax is officially deprecated
+[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:
+Many sites also support the
+.Dq percent hack
+for simplistic routing:
.Pp
.Dl user%hostc%hostb@hosta
.Pp
is routed as indicated in the previous example.
-.Ss Postmaster.
-.Pp
-Every site is required to have a user or user alias designated ``postmaster''
+.Ss Postmaster
+Every site is required to have a user or user alias designated
+.Dq postmaster
to which problems with the mail system may be addressed.
-.Ss Other Networks.
-.Pp
+.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.
+can often be sent to
+.Dq user@host.CSNET
+or
+.Dq user@host.BITNET ,
+respectively.
.Sh SEE ALSO
.Xr mail 1 ,
.Xr sendmail 8
@@ -145,11 +165,15 @@ Crocker, D. H.,
.Em Standard for the Format of Arpa Internet Text Messages,
RFC822.
.Sh HISTORY
-.Nm Mailaddr
+.Nm
appeared in 4.2 BSD.
.Sh BUGS
-The RFC822 group syntax (``group:user1,user2,user3;'') is not supported
-except in the special case of ``group:;'' because of a conflict with old
+The RFC822 group syntax
+.Pq Dq group:user1,user2,user3;
+is not supported
+except in the special case of
+.Dq group:;
+because of a conflict with old
berknet-style addresses.
.Pp
Route-Address syntax is grotty.