[src/netbsd-8]: src/dist/pf/share/man Pull up following revision(s) (requeste...

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

details:   https://anonhg.NetBSD.org/src/rev/e834c8db88c8
branches:  netbsd-8
changeset: 851939:e834c8db88c8
user:      martin <martin%NetBSD.org@localhost>
date:      Sat Aug 25 11:21:53 2018 +0000

description:
Pull up following revision(s) (requested by maxv in ticket #978):

        dist/pf/share/man/man4/pfsync.4: revision 1.7
        dist/pf/share/man/man4/pf.4: revision 1.13
        dist/pf/share/man/man5/pf.os.5: revision 1.7
        dist/pf/share/man/man4/pflog.4: revision 1.7
        dist/pf/share/man/man5/pf.conf.5: revision 1.17

Add a bold note to say our PF is obsolete.

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/pf.4      |  11 +++++++++--
 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 +++++++++--
 5 files changed, 45 insertions(+), 10 deletions(-)

diffs (158 lines):

diff -r 79da085b7edb -r e834c8db88c8 dist/pf/share/man/man4/pf.4
--- a/dist/pf/share/man/man4/pf.4       Sat Aug 25 11:13:05 2018 +0000
+++ b/dist/pf/share/man/man4/pf.4       Sat Aug 25 11:21:53 2018 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: pf.4,v 1.12 2009/12/19 14:05:53 ahoka Exp $
+.\"    $NetBSD: pf.4,v 1.12.40.1 2018/08/25 11:21:53 martin Exp $
 .\"    $OpenBSD: pf.4,v 1.59 2007/05/31 19:19:51 jmc Exp $
 .\"
 .\" Copyright (C) 2001, Kjell Wooding.  All rights reserved.
@@ -27,7 +27,7 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.Dd December 19, 2009
+.Dd August 25, 2018
 .Dt PF 4
 .Os
 .Sh NAME
@@ -36,6 +36,13 @@
 .Sh SYNOPSIS
 .Cd "pseudo-device pf"
 .Sh DESCRIPTION
+.Bf -symbolic
+The NetBSD version of PF is obsolete, and its use is strongly discouraged.
+Use
+.Xr npf 7
+instead.
+.Pp
+.Ef
 Packet filtering takes place in the kernel.
 A pseudo-device,
 .Pa /dev/pf ,
diff -r 79da085b7edb -r e834c8db88c8 dist/pf/share/man/man4/pflog.4
--- a/dist/pf/share/man/man4/pflog.4    Sat Aug 25 11:13:05 2018 +0000
+++ b/dist/pf/share/man/man4/pflog.4    Sat Aug 25 11:21: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.6.40.1 2018/08/25 11:21:53 martin 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 25, 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 79da085b7edb -r e834c8db88c8 dist/pf/share/man/man4/pfsync.4
--- a/dist/pf/share/man/man4/pfsync.4   Sat Aug 25 11:13:05 2018 +0000
+++ b/dist/pf/share/man/man4/pfsync.4   Sat Aug 25 11:21: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.6.40.1 2018/08/25 11:21:53 martin 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 25, 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 79da085b7edb -r e834c8db88c8 dist/pf/share/man/man5/pf.conf.5
--- a/dist/pf/share/man/man5/pf.conf.5  Sat Aug 25 11:13:05 2018 +0000
+++ b/dist/pf/share/man/man5/pf.conf.5  Sat Aug 25 11:21: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.16.40.1 2018/08/25 11:21:54 martin 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 25, 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 79da085b7edb -r e834c8db88c8 dist/pf/share/man/man5/pf.os.5
--- a/dist/pf/share/man/man5/pf.os.5    Sat Aug 25 11:13:05 2018 +0000
+++ b/dist/pf/share/man/man5/pf.os.5    Sat Aug 25 11:21: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.6.40.1 2018/08/25 11:21:54 martin 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 25, 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