setcontext was removed in POSIX.1-2008

setcontext was removed in POSIX.1-2008

[Bruno Haible]

Hi,

man/man3/getcontext.3, which describes getcontext and setcontext, says
"POSIX.1-2008 removes the specification of getcontext",
making it look like setcontext was still present in POSIX.1-2008.

It isn't. setcontext is removed as well. See
https://pubs.opengroup.org/onlinepubs/9699919799.2008edition/xrat/V4_xsh_chap01.html
in the table "Removed Functions and Symbols in Issue 7".

It's just the rationale section
https://pubs.opengroup.org/onlinepubs/9699919799.2008edition/xrat/V4_xsh_chap03.html
where getcontext is mentioned but setcontext was forgotten.

Bruno

Re: setcontext was removed in POSIX.1-2008

[Alejandro Colomar]

[-- Attachment #1: Type: text/plain, Size: 2918 bytes --]

On Fri, Jun 28, 2024 at 11:08:00AM GMT, Bruno Haible wrote:
> Hi,

Hi Bruno!

> man/man3/getcontext.3, which describes getcontext and setcontext, says
> "POSIX.1-2008 removes the specification of getcontext",
> making it look like setcontext was still present in POSIX.1-2008.
> 
> It isn't. setcontext is removed as well. See
> https://pubs.opengroup.org/onlinepubs/9699919799.2008edition/xrat/V4_xsh_chap01.html
> in the table "Removed Functions and Symbols in Issue 7".
> 
> It's just the rationale section
> https://pubs.opengroup.org/onlinepubs/9699919799.2008edition/xrat/V4_xsh_chap03.html
> where getcontext is mentioned but setcontext was forgotten.

Thanks for the report!

This was fixed in

$ git describe --contains 4131356cdab8d37fc395ca5466a0401c8573380c
man-pages-6.04~26
$ git show 4131356cdab8d37fc395ca5466a0401c8573380c -- man3/getcontext.3
commit 4131356cdab8d37fc395ca5466a0401c8573380c
Author: Alejandro Colomar <alx@kernel.org>
Date:   Fri Mar 17 17:08:01 2023 +0100

    man*/, man-pages.7: VERSIONS, STANDARDS, HISTORY: Reorganize sections
    
    -  Add a new HISTORY section that covers the history of an API, both
       regarding implementations and regarding old standards.  This was
       previously covered in VERSIONS, and in some cases in STANDARDS.
    
    -  Repurpose VERSIONS to cover differing implementations in _current_
       systems.
    
    -  STANDARDS is reduced to only cover current versions of standards.
       That basically means only C11 (C99 has been superseeded by C11; C17
       is just a bugfix of C11, so not really a new version), and
       POSIX.1-2008 (*-2001 was superseeded by *-2008; *-2017 was just a
       bugfix for *-2008).  The section also mentions for example 'Linux',
       'GNU' or 'BSD' when a non-standard API is Linux- or GNU-only or if
       it's (de-facto) standard in the BSDs.
    
    -  In some cases content that should go into one of these sections was
       in NOTES.  Move it from there to where it corresponds.
    
    -  In the SYNOPSIS, I added [[deprecated]] in some functions that I
       found are deprecated by the relevant standards.
    
    -  A few other related changes...
    
    Cc: Oskari Pirhonen <xxc3ncoredxx@gmail.com>
    Signed-off-by: Alejandro Colomar <alx@kernel.org>

diff --git a/man3/getcontext.3 b/man3/getcontext.3
index c9561fbf4..3a35afca1 100644
--- a/man3/getcontext.3
+++ b/man3/getcontext.3
@@ -157,9 +157,11 @@ .SH ATTRIBUTES
 .ad
 .sp 1
 .SH STANDARDS
+None.
+.SH HISTORY
 SUSv2, POSIX.1-2001.
-POSIX.1-2008 removes the specification of
-.BR getcontext (),
+.PP
+POSIX.1-2008 removes these functions,
 citing portability issues, and
 recommending that applications be rewritten to use POSIX threads instead.
 .SH NOTES

> 
> Bruno

Have a lovely day!
Alex

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

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 833 bytes --]

Re: setcontext was removed in POSIX.1-2008

[Bruno Haible]

Alejandro Colomar wrote:
> This was fixed in

Thanks!

I had looked at "gitk man/man3/getcontext.3", but the move and move-back
of the file fooled me.

Bruno

Re: setcontext was removed in POSIX.1-2008

[Alejandro Colomar]

[-- Attachment #1: Type: text/plain, Size: 333 bytes --]

On Fri, Jun 28, 2024 at 01:10:27PM GMT, Bruno Haible wrote:
> Alejandro Colomar wrote:
> > This was fixed in
> 
> Thanks!
> 
> I had looked at "gitk man/man3/getcontext.3", but the move and move-back
> of the file fooled me.

Sorry about that.  :)

> 
> Bruno
> 
> 
> 
> 

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

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 833 bytes --]