Re: sem_*.3: Use Xr where appropriate

2023-02-11 Thread Jason McIntyre
On Sat, Feb 11, 2023 at 10:00:15AM -0500, Josiah Frentsos wrote:
> Index: sem_destroy.3
> ===

committed these, thanks.
jmc

> RCS file: /cvs/src/lib/libpthread/man/sem_destroy.3,v
> retrieving revision 1.6
> diff -u -p -r1.6 sem_destroy.3
> --- sem_destroy.3 5 Jun 2013 03:44:50 -   1.6
> +++ sem_destroy.3 11 Feb 2023 14:50:35 -
> @@ -47,7 +47,7 @@ After a successful call to
>  .Fn sem_destroy ,
>  .Fa sem
>  is unusable until re-initialized by another call to
> -.Fn sem_init .
> +.Xr sem_init 3 .
>  .Sh RETURN VALUES
>  .Rv -std sem_destroy
>  .Sh ERRORS
> Index: sem_init.3
> ===
> RCS file: /cvs/src/lib/libpthread/man/sem_init.3,v
> retrieving revision 1.7
> diff -u -p -r1.7 sem_init.3
> --- sem_init.36 Apr 2021 19:59:32 -   1.7
> +++ sem_init.311 Feb 2023 14:50:35 -
> @@ -54,21 +54,21 @@ Following a successful call to
>  .Fn sem_init ,
>  .Fa sem
>  can be used as an argument in subsequent calls to
> -.Fa sem_wait ,
> -.Fa sem_trywait ,
> -.Fa sem_post ,
> +.Xr sem_wait 3 ,
> +.Xr sem_trywait 3 ,
> +.Xr sem_post 3 ,
>  and
> -.Fa sem_destroy .
> +.Xr sem_destroy 3 .
>  .Fa sem
>  is no longer valid after a successful call to
> -.Fa sem_destroy .
> +.Xr sem_destroy 3 .
>  .Sh RETURN VALUES
>  .Rv -std sem_init
>  .Sh ERRORS
>  It is an error to call
> -.Fn sem_destroy
> +.Xr sem_destroy 3
>  on a named semaphore created by
> -.Fn sem_open .
> +.Xr sem_open 3 .
>  .Pp
>  .Fn sem_init
>  will fail if:
> Index: sem_open.3
> ===
> RCS file: /cvs/src/lib/libpthread/man/sem_open.3,v
> retrieving revision 1.11
> diff -u -p -r1.11 sem_open.3
> --- sem_open.322 Sep 2015 08:43:12 -  1.11
> +++ sem_open.311 Feb 2023 14:50:35 -
> @@ -62,7 +62,7 @@ to indicate an error.
>  It is an error to call
>  .Fn sem_close
>  with an unnamed semaphore or to call
> -.Fn sem_destroy
> +.Xr sem_destroy 3
>  with a named semaphore.
>  .Pp
>  .Fn sem_open
> Index: sem_post.3
> ===
> RCS file: /cvs/src/lib/libpthread/man/sem_post.3,v
> retrieving revision 1.5
> diff -u -p -r1.5 sem_post.3
> --- sem_post.35 Jun 2013 03:44:50 -   1.5
> +++ sem_post.311 Feb 2023 14:50:35 -
> @@ -47,7 +47,7 @@ If there are threads blocked on the sema
>  .Fn sem_post
>  is called, then the highest priority thread that has been blocked the 
> longest on
>  the semaphore will be allowed to return from
> -.Fn sem_wait .
> +.Xr sem_wait 3 .
>  .Pp
>  .Fn sem_post
>  is signal-reentrant and may be called within signal handlers.
> 



sem_*.3: Use Xr where appropriate

2023-02-11 Thread Josiah Frentsos
Index: sem_destroy.3
===
RCS file: /cvs/src/lib/libpthread/man/sem_destroy.3,v
retrieving revision 1.6
diff -u -p -r1.6 sem_destroy.3
--- sem_destroy.3   5 Jun 2013 03:44:50 -   1.6
+++ sem_destroy.3   11 Feb 2023 14:50:35 -
@@ -47,7 +47,7 @@ After a successful call to
 .Fn sem_destroy ,
 .Fa sem
 is unusable until re-initialized by another call to
-.Fn sem_init .
+.Xr sem_init 3 .
 .Sh RETURN VALUES
 .Rv -std sem_destroy
 .Sh ERRORS
Index: sem_init.3
===
RCS file: /cvs/src/lib/libpthread/man/sem_init.3,v
retrieving revision 1.7
diff -u -p -r1.7 sem_init.3
--- sem_init.3  6 Apr 2021 19:59:32 -   1.7
+++ sem_init.3  11 Feb 2023 14:50:35 -
@@ -54,21 +54,21 @@ Following a successful call to
 .Fn sem_init ,
 .Fa sem
 can be used as an argument in subsequent calls to
-.Fa sem_wait ,
-.Fa sem_trywait ,
-.Fa sem_post ,
+.Xr sem_wait 3 ,
+.Xr sem_trywait 3 ,
+.Xr sem_post 3 ,
 and
-.Fa sem_destroy .
+.Xr sem_destroy 3 .
 .Fa sem
 is no longer valid after a successful call to
-.Fa sem_destroy .
+.Xr sem_destroy 3 .
 .Sh RETURN VALUES
 .Rv -std sem_init
 .Sh ERRORS
 It is an error to call
-.Fn sem_destroy
+.Xr sem_destroy 3
 on a named semaphore created by
-.Fn sem_open .
+.Xr sem_open 3 .
 .Pp
 .Fn sem_init
 will fail if:
Index: sem_open.3
===
RCS file: /cvs/src/lib/libpthread/man/sem_open.3,v
retrieving revision 1.11
diff -u -p -r1.11 sem_open.3
--- sem_open.3  22 Sep 2015 08:43:12 -  1.11
+++ sem_open.3  11 Feb 2023 14:50:35 -
@@ -62,7 +62,7 @@ to indicate an error.
 It is an error to call
 .Fn sem_close
 with an unnamed semaphore or to call
-.Fn sem_destroy
+.Xr sem_destroy 3
 with a named semaphore.
 .Pp
 .Fn sem_open
Index: sem_post.3
===
RCS file: /cvs/src/lib/libpthread/man/sem_post.3,v
retrieving revision 1.5
diff -u -p -r1.5 sem_post.3
--- sem_post.3  5 Jun 2013 03:44:50 -   1.5
+++ sem_post.3  11 Feb 2023 14:50:35 -
@@ -47,7 +47,7 @@ If there are threads blocked on the sema
 .Fn sem_post
 is called, then the highest priority thread that has been blocked the longest 
on
 the semaphore will be allowed to return from
-.Fn sem_wait .
+.Xr sem_wait 3 .
 .Pp
 .Fn sem_post
 is signal-reentrant and may be called within signal handlers.