From owner-svn-src-all@freebsd.org Sat Nov 11 19:21:28 2017 Return-Path: Delivered-To: svn-src-all@mailman.ysv.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) by mailman.ysv.freebsd.org (Postfix) with ESMTP id 9969BE71E2C; Sat, 11 Nov 2017 19:21:28 +0000 (UTC) (envelope-from freebsd@pdx.rh.CN85.dnsmgr.net) Received: from pdx.rh.CN85.dnsmgr.net (br1.CN84in.dnsmgr.net [69.59.192.140]) (using TLSv1 with cipher DHE-RSA-AES256-SHA (256/256 bits)) (Client did not present a certificate) by mx1.freebsd.org (Postfix) with ESMTPS id 08C936BB2A; Sat, 11 Nov 2017 19:21:28 +0000 (UTC) (envelope-from freebsd@pdx.rh.CN85.dnsmgr.net) Received: from pdx.rh.CN85.dnsmgr.net (localhost [127.0.0.1]) by pdx.rh.CN85.dnsmgr.net (8.13.3/8.13.3) with ESMTP id vABJLP2t035443; Sat, 11 Nov 2017 11:21:25 -0800 (PST) (envelope-from freebsd@pdx.rh.CN85.dnsmgr.net) Received: (from freebsd@localhost) by pdx.rh.CN85.dnsmgr.net (8.13.3/8.13.3/Submit) id vABJLPtL035442; Sat, 11 Nov 2017 11:21:25 -0800 (PST) (envelope-from freebsd) From: "Rodney W. Grimes" Message-Id: <201711111921.vABJLPtL035442@pdx.rh.CN85.dnsmgr.net> Subject: Re: svn commit: r325702 - in head: . share/man/man5 share/man/man7 usr.bin/mail In-Reply-To: <201711110700.vAB70e9P052013@repo.freebsd.org> To: Eitan Adler Date: Sat, 11 Nov 2017 11:21:25 -0800 (PST) CC: src-committers@freebsd.org, svn-src-all@freebsd.org, svn-src-head@freebsd.org Reply-To: rgrimes@freebsd.org X-Mailer: ELM [version 2.4ME+ PL121h (25)] MIME-Version: 1.0 Content-Transfer-Encoding: 7bit Content-Type: text/plain; charset=US-ASCII X-BeenThere: svn-src-all@freebsd.org X-Mailman-Version: 2.1.23 Precedence: list List-Id: "SVN commit messages for the entire src tree \(except for " user" and " projects" \)" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sat, 11 Nov 2017 19:21:28 -0000 > 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@domain where a domain is a hierarchical dot separated list of subdomains. For example, a valid address is: eric@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@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@freebsd.org