Re: [PATCH 07/11] setjmp.3: fix section references

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



Hi Kir,

On Sat, Jun 15, 2024 at 06:19:00PM GMT, Kir Kolyshkin wrote:
> Commit 4131356cd ("man*/, man-pages.7: VERSIONS, STANDARDS, HISTORY:
> Reorganize sections") results in a few problems with setjmp(3):
> 
>  1. "Feature Test Macro Requirements for glibc" refers to NOTES, while
>     those macros are now described in HISTORY.
> 
>  2. The discussion about saving signal mask is now split between HISTORY
>     and NOTES.
> 
> To fix all this, let's remove NOTES and fix references to point to
> HISTORY.
> 
> Fixes: 4131356cd
> Signed-off-by: Kir Kolyshkin <kolyshkin@xxxxxxxxx>
> ---
>  man/man3/setjmp.3 | 6 +++---
>  1 file changed, 3 insertions(+), 3 deletions(-)
> 
> diff --git a/man/man3/setjmp.3 b/man/man3/setjmp.3
> index 2319feb47..1403d6ba7 100644
> --- a/man/man3/setjmp.3
> +++ b/man/man3/setjmp.3
> @@ -26,7 +26,7 @@ .SH SYNOPSIS
>  .RE
>  .P
>  .BR setjmp ():
> -see NOTES.
> +see HISTORY.
>  .P
>  .BR sigsetjmp ():
>  .nf
> @@ -65,7 +65,7 @@ .SH DESCRIPTION
>  was called and to restore ("rewind") the stack to its state at the time of the
>  .BR setjmp ()
>  call.
> -In addition, and depending on the implementation (see NOTES),
> +In addition, and depending on the implementation (see HISTORY),
>  the values of some other registers and the process signal mask
>  may be restored to their state at the time of the
>  .BR setjmp ()
> @@ -201,7 +201,7 @@ .SH HISTORY
>  with a nonzero
>  .I savesigs
>  argument.
> -.SH NOTES
> +.P

But the paragraph below is not about HISTORY.  It's current stuff (which
is why I kept it).  How about saying "see NOTES and HISTORY"?

Cheers,
Alex

>  .BR setjmp ()
>  and
>  .BR longjmp ()
> -- 
> 2.45.2
> 

-- 
<https://www.alejandro-colomar.es/>

Attachment: signature.asc
Description: PGP signature


[Index of Archives]     [Kernel Documentation]     [Netdev]     [Linux Ethernet Bridging]     [Linux Wireless]     [Kernel Newbies]     [Security]     [Linux for Hams]     [Netfilter]     [Bugtraq]     [Yosemite News]     [MIPS Linux]     [ARM Linux]     [Linux RAID]     [Linux Admin]     [Samba]

  Powered by Linux