Thank you Joerg for your comments on the manpage diff. But it looks like Gilles has already committed the diff according to his previous response. Thank you Gilles!
Just in case, I am including the updated diff as I reworded it as well. Gilles, Joerg, could you please see if rewording makes the listen on directive less ambiguous. Thank you! --peter Index: smtpd.conf.5 =================================================================== RCS file: /cvs/src/usr.sbin/smtpd/smtpd.conf.5,v retrieving revision 1.153 diff -u -p -r1.153 smtpd.conf.5 --- smtpd.conf.5 21 Jan 2016 23:40:27 -0000 1.153 +++ smtpd.conf.5 13 Feb 2016 20:55:33 -0000 @@ -654,6 +654,12 @@ of inflight envelopes falls below Changing the default value might degrade performance. .It Xo .Bk -words +.Ic listen on socket +.Op Ic filter Ar name +.Op Ic mask-source +.Ek +.br +.Bk -words .Ic listen on Ar interface .Op Ar family .Op Ic port Ar port @@ -671,11 +677,35 @@ Changing the default value might degrade .Ek .Xc .Pp -Specify an +Specify a +.Ic socket +or an +.Ar interface +to listen on for incoming connections. +A +.Ic listen on socket +directive is used to customize the listening behavior for messages +submitted through local queues, for example, via the +.Xr mail 1 +utility. +This is an optional directive. +By default, +.Xr smtpd 8 +will listen for local connections on the +.Ic socket , +.Ic inet4 +and/or +.Ic inet6 +interfaces will not be enabled. +Clients connecting through the +.Ic socket +will always be tagged with the 'local' +.Ic tag . +.Pp +To listen on a specific network interface, specify an .Ar interface -and -.Ar port -to listen on. +and an optional +.Ar port . An interface group, an IP address or a domain name may be used in place of .Ar interface .
