On Mon, Jun 17, 2024 at 04:59:16PM +0200, Mark Kettenis wrote:
> > It seems -susv1, -susv3, and -susv4 are not used in man pages in
> > base at all (other than mdoc). The handful of references to -susv2
> > in lib/libpthread could be replaced with references to ISO 1003.1?
> 
> Almost certainly not.  POSIX was only a subset of SUS.  The two were
> merged in v6 with the X/Open System Interfaces becoming an extension
> to POSIX.  Some of those interfaces became standard POSIX interfaces
> in later revisions.

Surely pthread_getconcurrency, pthread_getschedparam,
pthread_mutexattr_destroy, pthread_mutexattr_getprioceiling,
pthread_mutexattr_getprotocol, pthread_mutexattr_gettype,
pthread_mutexattr_init, pthread_mutexattr_setprioceiling,
pthread_mutexattr_setprotocol, pthread_mutexattr_settype,
pthread_rwlock_destroy, pthread_rwlock_init, pthread_rwlock_rdlock,
pthread_rwlock_timedrdlock, pthread_rwlock_timedwrlock,
pthread_rwlock_tryrdlock, pthread_rwlock_trywrlock,
pthread_rwlock_unlock, pthread_rwlock_wrlock,
pthread_rwlockattr_destroy, pthread_rwlockattr_getpshared,
pthread_rwlockattr_init, pthread_rwlockattr_setpshared,
pthread_setconcurrency, and pthread_setschedparam, aren't exclusively
standardized via SUS v2?

For example pthread_rwlock_rdlock also seems to have been standardized
in IEEE Std 1003.1, 2004 Edition
https://pubs.opengroup.org/onlinepubs/009695399/functions/pthread_rwlock_rdlock.html

So the below diff (as an example) seems a correct way of getting rid of
a -susv2 reference, right?

Index: pthread_rwlock_rdlock.3
===================================================================
RCS file: /cvs/src/lib/libpthread/man/pthread_rwlock_rdlock.3,v
diff -u -p -r1.12 pthread_rwlock_rdlock.3
--- pthread_rwlock_rdlock.3	13 Feb 2019 23:54:10 -0000	1.12
+++ pthread_rwlock_rdlock.3	17 Jun 2024 16:49:49 -0000
@@ -138,7 +138,7 @@ The
 and
 .Fn pthread_rwlock_tryrdlock
 functions are expected to conform to
-.St -susv2 .
+.St -p1003.1-2004 .
 .Sh HISTORY
 The
 .Fn pthread_rwlock_rdlock