[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/a7aead4015e0
branches:  trunk
changeset: 840051:a7aead4015e0
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 33a67e066d63 -r a7aead4015e0 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