Re: [PATCH 1/1] document posix_openpt

[Gavin Smith <gavinsmith0123@gmail.com>]

On Wed, Apr 19, 2023 at 09:43:01AM -0300, Adhemerval Zanella Netto wrote:

> LGTM, I am just no sure which standard to use.
> 
> > 
> > diff --git a/manual/terminal.texi b/manual/terminal.texi
> > index 7293bfb393..bdaee56053 100644
> > --- a/manual/terminal.texi
> > +++ b/manual/terminal.texi
> > @@ -1947,6 +1947,33 @@ This subsection describes functions for allocating a pseudo-terminal,
> >  and for making this pseudo-terminal available for actual use.  These
> >  functions are declared in the header file @file{stdlib.h}.
> >  
> > +@deftypefun int posix_openpt (int @var{flags})
> > +@standards{POSIX.1, stdlib.h}
> 
> Shouldn't it be POSIX.2, since it is define for _XOPEN_SOURCE >= 600?

I got from the "feature_test_macros" manpage:

  (Since glibc 2.2) The value 600 or greater additionally  ex‐
  poses definitions for SUSv3 (UNIX 03; i.e., the POSIX.1-2001
  base specification plus the XSI extension) and  C99  defini‐
  tions.

This is why I thought "POSIX.1" was the most appropriate.

POSIX.2 is mentioned in the libc manual, but it doesn't appear to cover
pseudo-terminal functionality:

     Some facilities from ‘ISO/IEC 9945-2:1993, the POSIX Shell and
  Utilities standard’ (POSIX.2) are also implemented in the GNU C Library.
  These include utilities for dealing with regular expressions and other
  pattern matching facilities

Existing uses of @standards{POSIX.2, ...} in the manual are consistent
with this.

'./summary.pl --help' doesn't offer any further guidance.