[src/trunk]: src/bin/pax pax.1: document the "s" flag of the "s" option

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

details:   https://anonhg.NetBSD.org/src/rev/536f0772e4b8
branches:  trunk
changeset: 449733:536f0772e4b8
user:      gutteridge <gutteridge%NetBSD.org@localhost>
date:      Tue Mar 19 00:12:08 2019 +0000

description:
pax.1: document the "s" flag of the "s" option

Note the "s" option has an "s" flag that "prevents substitutions from
being performed on symbolic link destinations". Carry over r. 1.25 from
christos@ and part of r. 1.26 from wiz@ from tar.1, since this
functionality is available in pax as well as tar.

diffstat:

 bin/pax/pax.1 |  11 ++++++++---
 1 files changed, 8 insertions(+), 3 deletions(-)

diffs (39 lines):

diff -r bfe568f25a50 -r 536f0772e4b8 bin/pax/pax.1
--- a/bin/pax/pax.1     Tue Mar 19 00:11:34 2019 +0000
+++ b/bin/pax/pax.1     Tue Mar 19 00:12:08 2019 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: pax.1,v 1.69 2017/07/03 21:33:23 wiz Exp $
+.\"    $NetBSD: pax.1,v 1.70 2019/03/19 00:12:08 gutteridge Exp $
 .\"
 .\" Copyright (c) 1992 Keith Muller.
 .\" Copyright (c) 1992, 1993
@@ -33,7 +33,7 @@
 .\"
 .\"    @(#)pax.1       8.4 (Berkeley) 4/18/94
 .\"
-.Dd August 12, 2016
+.Dd March 19, 2019
 .Dt PAX 1
 .Os
 .Sh NAME
@@ -572,7 +572,7 @@
 .Xr ed 1
 utility regular expressions.
 The format of these regular expressions are:
-.Dl /old/new/[gp]
+.Dl /old/new/[gps]
 As in
 .Xr ed 1 ,
 .Cm old
@@ -607,6 +607,11 @@
 .Dl Ao "original pathname" Ac >> Ao "new pathname" Ac
 File or archive member names that substitute to the empty string
 are not selected and will be skipped.
+The substitutions are applied by default to the destination hard and symbolic
+links.
+The optional trailing
+.Cm s
+prevents the substitutions from being performed on symbolic link destinations.
 .It Fl t
 Reset the access times of any file or directory read or accessed by
 .Nm