[src/trunk]: src/usr.sbin/pf/pfs Sort options, standardize SYNOPSIS, slight r...

[wiz <wiz%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/c0e567a719af
branches:  trunk
changeset: 754687:c0e567a719af
user:      wiz <wiz%NetBSD.org@localhost>
date:      Sat May 08 11:29:40 2010 +0000

description:
Sort options, standardize SYNOPSIS, slight rewordings. Use more markup.

diffstat:

 usr.sbin/pf/pfs/pfs.8 |  74 ++++++++++++++++++++++++++------------------------
 1 files changed, 38 insertions(+), 36 deletions(-)

diffs (115 lines):

diff -r dfe911dd23a7 -r c0e567a719af usr.sbin/pf/pfs/pfs.8
--- a/usr.sbin/pf/pfs/pfs.8     Sat May 08 11:22:58 2010 +0000
+++ b/usr.sbin/pf/pfs/pfs.8     Sat May 08 11:29:40 2010 +0000
@@ -3,73 +3,75 @@
 .Os
 .Sh NAME
 .Nm pfs 
-.Nd saves and restores information for NAT and state tables.
+.Nd save and restore information for NAT and state tables.
 .Sh SYNOPSIS
 .Nm
 .Op Fl v
 .Fl l
 .Nm
-.Op Fl v
-.Fl u
-.Nm
-.Op Fl v
-.Op Fl b
-.Fl w
+.Op Fl bv
+.Fl R
 .Ar filename
 .Nm
-.Op Fl v
-.Op Fl b
+.Op Fl bv
 .Fl r
 .Ar filename
 .Nm
 .Op Fl v
-.Op Fl b
-.Fl R
+.Fl u
+.Nm
+.Op Fl bv
+.Fl W
 .Ar filename
 .Nm
-.Op Fl v
-.Op Fl b
-.Fl W
+.Op Fl bv
+.Fl w
 .Ar filename
 .Sh DESCRIPTION
 The
 .Nm
 command allows state information created for NAT entries and rules using
-.Pa keep state
+.Dq keep state
 to be locked (modification prevented) and then saved to disk,
 allowing for the system to experience a reboot, followed by the restoration
 of that information, resulting in connections not being interrupted.
 .Sh OPTIONS
-.Bl -tag -width indent
+.Bl -tag -width XrXfilenameXX
 .It Fl b
-The information are read or stored using binary format. The default format is
-a readable ascii format, similar to 
+The information are read or stored using binary format.
+The default format is a readable ASCII format, similar to 
 .Pa pfctl.conf 
 syntax.
-.It Fl v
-Provides a verbose description of what's being done.
-.It Fl u
-Unlock state tables in the kernel.
 .It Fl l
 Lock state tables in the kernel.
-.It Fl r
-Read information in from the specified file and load it into the
-kernel.  This requires the state tables to have already been locked
-and does not change the lock once complete.
-.It Fl w
-Write information out to the specified file and from the kernel.
+.It Fl R Ar filename
+Restore information from
+.Ar filename
+and load it into the kernel.
+The state tables are locked at the beginning of this operation and
+unlocked once complete.
+.It Fl r Ar filename
+Read information in from
+.Ar filename
+and load it into the kernel.
 This requires the state tables to have already been locked
 and does not change the lock once complete.
-.It Fl R
-Restores  information in from the specified file and load it into the
-kernel.  The state tables are locked at the beginning of this operation and
+.It Fl u
+Unlock state tables in the kernel.
+.It Fl v
+Provide a verbose description of what's being done.
+.It Fl W Ar filename
+Write information from the kernel out to
+.Ar filename .
+The state tables are locked at the beginning of this operation and
 unlocked once complete.
-.It Fl W
-Write information out to the specified file and from the kernel.  The state
-tables are locked at the beginning of this operation and unlocked once
-complete.
+.It Fl w Ar filename
+Write information from the kernel out to
+.Ar filename .
+This requires the state tables to have already been locked
+and does not change the lock once complete.
 .El
 .Sh FILES
-/dev/pf
+.Pa /dev/pf
 .Sh SEE ALSO
 .Xr pf 4