svn commit: r325702 - in head: . share/man/man5 share/man/man7 usr.bin/mail

[Rodney W. Grimes]

> Author: eadler
> Date: Sat Nov 11 07:00:40 2017
> New Revision: 325702
> URL: https://svnweb.freebsd.org/changeset/base/325702
> 
> Log:
>   mailaddr(7): wave goodbye
>   
>   The information here is somewhere between ancient to obsolete.

20% of the information here is somewhat obsolete, 80% of it is 
valid, can you please tell me what part of the following main
body of the page are either ancient or obsolete:

Begin man page sectoin
DESCRIPTION
     Mail addresses are based on the Internet protocol listed at the end of
     this manual page.  These addresses are in the general format

           user at domain

     where a domain is a hierarchical dot separated list of subdomains.  For
     example, a valid address is:

           eric at CS.Berkeley.EDU

     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.

   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 at CS''
     without adding the ``berkeley.edu'' since it is the same on both sending
     and receiving hosts.

End man page secton.


>   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.

A TINY part of it refered to UUCP and berknet, so rather than simply
correct the 20% of the one file you removed the 80% valid information
and touched  5 other files.  Thus, imho, does not move the state of
FreeBSD forward.
>   
>   It seems unlikely that a manual page in this form would be useful, so
>   just remove it.

I think the information that was correct would be usefull to a new
person to internet mail address formats.   I think even bdrewey
commented in the Differential that he learned a lot from reading
this man page.  

>   
>   Reviewed By: imp, tsoome, bdrewery(?)
>   Differential Revision: https://reviews.freebsd.org/D12924

You might of wanted to get a docs/manpage reviewer before commit.

> 
> Deleted:
>   head/share/man/man7/mailaddr.7
> Modified:
>   head/ObsoleteFiles.inc
>   head/share/man/man5/forward.5
>   head/share/man/man7/Makefile
>   head/share/man/man7/hostname.7
>   head/usr.bin/mail/mail.1
> 
> Modified: head/ObsoleteFiles.inc


--
Rod Grimes                                                 rgrimes at freebsd.org