svn commit: r314563 - head/usr.sbin/syslogd

[Ngie Cooper]

Author: ngie
Date: Thu Mar  2 18:07:19 2017
New Revision: 314563
URL: https://svnweb.freebsd.org/changeset/base/314563

Log:
  Wordsmith syslogd(8)
  
  - Clarify -p/-S options by using appropriate subject-verb modifiers
    (verb and modifiers suggested that the subject should have been
    singular).
  - Simplify/correct -a description:
  -- Be more terse when describing IPv4 (the "usual dotted notation"
     isn't necessarily well understood by the reader). Being blunt and
     saying "IPv4 address" with an optional netmask is.
  -- prefixlen is the appropriate terminology for IPv6.
  -- mask/prefixlen is optional, not required (as noted later on in the
     section).
  -- split up IPv4/IPv6 use so to clarify both forms.
  -- Fix wordiness when describing the optional "service" specifier.
  - -T: Use "cannot" instead of "can't" [*].
  
  Bump .Dd for the changes.
  
  MFC after:	1 month
  Reported by:	igor [*]
  Reviewed by:	hrs
  Sponsored by:	Dell EMC Isilon
  Differential Revision:	https://reviews.freebsd.org/D9855

Modified:
  head/usr.sbin/syslogd/syslogd.8

Modified: head/usr.sbin/syslogd/syslogd.8
==============================================================================
--- head/usr.sbin/syslogd/syslogd.8	Thu Mar  2 17:35:13 2017	(r314562)
+++ head/usr.sbin/syslogd/syslogd.8	Thu Mar  2 18:07:19 2017	(r314563)
@@ -28,7 +28,7 @@
 .\"     @(#)syslogd.8	8.1 (Berkeley) 6/6/93
 .\" $FreeBSD$
 .\"
-.Dd December 21, 2016
+.Dd March 2, 2017
 .Dt SYSLOGD 8
 .Os
 .Sh NAME
@@ -102,21 +102,23 @@ options may be specified.
 The
 .Ar allowed_peer
 option may be any of the following:
-.Bl -tag -width "ipaddr/masklen[:service]XX"
+.Bl -tag -width "ipaddr[/prefixlen][:service]XX"
 .It Xo
 .Sm off
 .Ar ipaddr
-.No / Ar masklen
+.Op / Ar masklen
+.Op \&: Ar service
+.Pp
+.Ar ipaddr
+.Op / Ar prefixlen
 .Op \&: Ar service
 .Sm on
 .Xc
 Accept datagrams from
+.Ar ipaddr ,
 .Ar ipaddr
-(in the usual dotted quad notation) with
-.Ar masklen
-bits being taken into account when doing the address comparison.
-.Ar ipaddr
-can be also IPv6 address by enclosing the address with
+can be specified as an IPv4 address or as an IPv6
+address enclosed with
 .Ql \&[
 and
 .Ql \&] .
@@ -129,7 +131,7 @@ A
 .Ar service
 of
 .Ql \&*
-allows packets being sent from any UDP port.
+allows packets to be sent from any UDP port.
 The default
 .Ar service
 is
@@ -265,7 +267,7 @@ the default is
 .Pa /var/run/log .
 When a single
 .Fl p
-options are specified,
+option is specified,
 the default pathname is replaced with the specified one.
 When two or more
 .Fl p
@@ -282,7 +284,7 @@ the default is
 .Pa /var/run/logpriv .
 When a single
 .Fl S
-options are specified,
+option is specified,
 the default pathname is replaced with the specified one.
 When two or more
 .Fl S
@@ -309,7 +311,7 @@ which also disables logging to remote ma
 .It Fl T
 Always use the local time and date for messages received from the network,
 instead of the timestamp field supplied in the message by the remote host.
-This is useful if some of the originating hosts can't keep time properly
+This is useful if some of the originating hosts cannot keep time properly
 or are unable to generate a correct timestamp.
 .It Fl u
 Unique priority logging.