Re: [PATCH v2 01/23] man/man2/clock_getres.2: HISTORY: Update first POSIX appearance of clock_* syscalls

[Alejandro Colomar <alx@kernel.org>]

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

Hi Mark, Seth,

On Wed, Jan 21, 2026 at 07:37:33PM -0800, Mark Harris wrote:
> Seth McDonald wrote:
> >
> > clock_getres(2), clock_gettime(2), and clock_settime(2) first appeared
> > in POSIX.1-1996.[1]  SUSv2 incorporates POSIX.1-1996, so listing both is
> > redundant.
> 
> Technically these functions came from POSIX.1b (1003.1b-1993), which
> was a set of optional realtime extensions to POSIX, published as a
> separate document.  POSIX.1-1996 integrated them into the main
> standard (1003.1-1996) as part of a Timers extension.  In 1997 X/Open
> adopted them to SUSv2 as part of their own X/Open Realtime extension,
> which includes the POSIX Timers extension and other extensions that
> had been added to POSIX from POSIX.1b.

Thanks!  For now, I think I'll take the patch, even if the commit
message is factually incorrect.  We can then do a future round of
patches researching those less common POSIX extension standard.

Does this sound good?


Have a lovely day!
Alex

> 
>  - Mark
> 
> >
> > [1] ISO/IEC 9945-1:1996, Section 14.2.1 "Clocks".
> >
> > Signed-off-by: Seth McDonald <sethmcmail@pm.me>
> > ---
> >  man/man2/clock_getres.2 | 2 +-
> >  1 file changed, 1 insertion(+), 1 deletion(-)
> >
> > diff --git a/man/man2/clock_getres.2 b/man/man2/clock_getres.2
> > index 5f8ed14f1555..1a486c886229 100644
> > --- a/man/man2/clock_getres.2
> > +++ b/man/man2/clock_getres.2
> > @@ -369,7 +369,7 @@ .SS C library/kernel differences
> >  .SH STANDARDS
> >  POSIX.1-2024.
> >  .SH HISTORY
> > -POSIX.1-2001, SUSv2.
> > +POSIX.1-1996,
> >  Linux 2.6.
> >  .P
> >  On POSIX systems on which these functions are available, the symbol
> > --
> > 2.47.3
> >

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

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