[src/trunk]: src/dist/pf/share/man Add a deprecation note in each of the PF m...

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

details:   https://anonhg.NetBSD.org/src/rev/acd5a8946f08
branches:  trunk
changeset: 363952:acd5a8946f08
user:      maxv <maxv%NetBSD.org@localhost>
date:      Fri Aug 17 12:36:53 2018 +0000

description:
Add a deprecation note in each of the PF man pages (instead of just pf.4),
so that it's really clear.

diffstat:

 dist/pf/share/man/man4/pflog.4   |  11 +++++++++--
 dist/pf/share/man/man4/pfsync.4  |  11 +++++++++--
 dist/pf/share/man/man5/pf.conf.5 |  11 +++++++++--
 dist/pf/share/man/man5/pf.os.5   |  11 +++++++++--
 4 files changed, 36 insertions(+), 8 deletions(-)

diffs (126 lines):

diff -r fb7dae265f8b -r acd5a8946f08 dist/pf/share/man/man4/pflog.4
--- a/dist/pf/share/man/man4/pflog.4    Fri Aug 17 12:20:49 2018 +0000
+++ b/dist/pf/share/man/man4/pflog.4    Fri Aug 17 12:36:53 2018 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: pflog.4,v 1.6 2009/03/22 14:29:34 perry Exp $
+.\"    $NetBSD: pflog.4,v 1.7 2018/08/17 12:36:53 maxv Exp $
 .\"    $OpenBSD: pflog.4,v 1.10 2007/05/31 19:19:51 jmc Exp $
 .\"
 .\" Copyright (c) 2001 Tobias Weingartner
@@ -24,7 +24,7 @@
 .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
 .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 .\"
-.Dd May 31, 2007
+.Dd August 17, 2018
 .Dt PFLOG 4
 .Os
 .Sh NAME
@@ -33,6 +33,13 @@
 .Sh SYNOPSIS
 .Cd "pseudo-device pflog"
 .Sh DESCRIPTION
+.Bf -symbolic
+The NetBSD version of PF is obsolete, and its use is strongly discouraged.
+Use
+.Xr npf 7
+instead.
+.Pp
+.Ef
 The
 .Nm pflog
 interface is a pseudo-device which makes visible all packets logged by
diff -r fb7dae265f8b -r acd5a8946f08 dist/pf/share/man/man4/pfsync.4
--- a/dist/pf/share/man/man4/pfsync.4   Fri Aug 17 12:20:49 2018 +0000
+++ b/dist/pf/share/man/man4/pfsync.4   Fri Aug 17 12:36:53 2018 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: pfsync.4,v 1.6 2010/04/12 21:28:23 wiz Exp $
+.\"    $NetBSD: pfsync.4,v 1.7 2018/08/17 12:36:53 maxv Exp $
 .\"    $OpenBSD: pfsync.4,v 1.25 2007/05/31 19:19:51 jmc Exp $
 .\"
 .\" Copyright (c) 2002 Michael Shalayeff
@@ -25,7 +25,7 @@
 .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
 .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 .\"
-.Dd April 12, 2010
+.Dd August 17, 2018
 .Dt PFSYNC 4
 .Os
 .Sh NAME
@@ -34,6 +34,13 @@
 .Sh SYNOPSIS
 .Cd "pseudo-device pfsync"
 .Sh DESCRIPTION
+.Bf -symbolic
+The NetBSD version of PF is obsolete, and its use is strongly discouraged.
+Use
+.Xr npf 7
+instead.
+.Pp
+.Ef
 The
 .Nm
 interface is a pseudo-device which exposes certain changes to the state
diff -r fb7dae265f8b -r acd5a8946f08 dist/pf/share/man/man5/pf.conf.5
--- a/dist/pf/share/man/man5/pf.conf.5  Fri Aug 17 12:20:49 2018 +0000
+++ b/dist/pf/share/man/man5/pf.conf.5  Fri Aug 17 12:36:53 2018 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: pf.conf.5,v 1.16 2009/10/14 17:44:25 joerg Exp $
+.\"    $NetBSD: pf.conf.5,v 1.17 2018/08/17 12:36:53 maxv Exp $
 .\"    $OpenBSD: pf.conf.5,v 1.383 2007/07/17 16:27:38 jmc Exp $
 .\"
 .\" Copyright (c) 2002, Daniel Hartmeier
@@ -28,13 +28,20 @@
 .\" ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 .\" POSSIBILITY OF SUCH DAMAGE.
 .\"
-.Dd June 26, 2007
+.Dd August 17, 2018
 .Dt PF.CONF 5
 .Os
 .Sh NAME
 .Nm pf.conf
 .Nd packet filter configuration file
 .Sh DESCRIPTION
+.Bf -symbolic
+The NetBSD version of PF is obsolete, and its use is strongly discouraged.
+Use
+.Xr npf 7
+instead.
+.Pp
+.Ef
 The
 .Xr pf 4
 packet filter modifies, drops or passes packets according to rules or
diff -r fb7dae265f8b -r acd5a8946f08 dist/pf/share/man/man5/pf.os.5
--- a/dist/pf/share/man/man5/pf.os.5    Fri Aug 17 12:20:49 2018 +0000
+++ b/dist/pf/share/man/man5/pf.os.5    Fri Aug 17 12:36:53 2018 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: pf.os.5,v 1.6 2009/03/22 14:29:35 perry Exp $
+.\"    $NetBSD: pf.os.5,v 1.7 2018/08/17 12:36:53 maxv Exp $
 .\"    $OpenBSD: pf.os.5,v 1.8 2007/05/31 19:19:58 jmc Exp $
 .\"
 .\" Copyright (c) 2003 Mike Frantzen <frantzen%w4g.org@localhost>
@@ -14,13 +14,20 @@
 .\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
 .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
 .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
-.Dd May 31, 2007
+.Dd August 17, 2018
 .Dt PF.OS 5
 .Os
 .Sh NAME
 .Nm pf.os
 .Nd format of the operating system fingerprints file
 .Sh DESCRIPTION
+.Bf -symbolic
+The NetBSD version of PF is obsolete, and its use is strongly discouraged.
+Use
+.Xr npf 7
+instead.
+.Pp
+.Ef
 The
 .Xr pf 4
 firewall and the