From 95b209a8cf3fb9b3900509a219568ea528fa3c7e Mon Sep 17 00:00:00 2001
From: wiz <wiz@NetBSD.org>
Date: Sat, 8 May 2010 11:29:40 +0000
Subject: [PATCH] Sort options, standardize SYNOPSIS, slight rewordings. Use
 more markup.

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

diff --git a/usr.sbin/pf/pfs/pfs.8 b/usr.sbin/pf/pfs/pfs.8
index b81919e14e02..82cc56a2765d 100644
--- a/usr.sbin/pf/pfs/pfs.8
+++ b/usr.sbin/pf/pfs/pfs.8
@@ -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