mirror of https://github.com/mkerrisk/man-pages
kill.2, sigaction.2, sigpending.2, sigprocmask.2, sigsuspend.2, ctermid.3, ctime.3, ferror.3, flockfile.3, fopen.3, getaddrinfo.3, getgrnam.3, getnameinfo.3, getpwnam.3, rand.3, sigsetops.3, sigwait.3, strtok.3, tzset.3, unlocked_stdio.3, feature_test_macros.7: Remove mention of the obsolete _POSIX_SOURCE macro from SYNOPSIS
_POSIX_SOURCE was a POSIX.1-1990 creation that was soon made obsolete bu _POSIX_C_SOURCE. Retaining mention of it in the feature test macro requirements section of the SYNOPSIS doesn't contain important information, and may mislead readers into actually trying to use this macro. A few mentions of it a maintained in a some pages where defining _POSIX_SOURCE inhibits some behavior. Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
This commit is contained in:
parent
c4a256e267
commit
c1016e8767
|
@ -60,7 +60,7 @@ Feature Test Macro Requirements for glibc (see
|
|||
.sp
|
||||
.ad l
|
||||
.BR kill ():
|
||||
_POSIX_C_SOURCE\ >=\ 1 || _XOPEN_SOURCE || _POSIX_SOURCE
|
||||
_POSIX_C_SOURCE\ >=\ 1 || _XOPEN_SOURCE
|
||||
.ad b
|
||||
.SH DESCRIPTION
|
||||
The
|
||||
|
|
|
@ -64,7 +64,7 @@ Feature Test Macro Requirements for glibc (see
|
|||
.sp
|
||||
.ad l
|
||||
.BR sigaction ():
|
||||
_POSIX_C_SOURCE\ >=\ 1 || _XOPEN_SOURCE || _POSIX_SOURCE
|
||||
_POSIX_C_SOURCE\ >=\ 1 || _XOPEN_SOURCE
|
||||
|
||||
.IR siginfo_t :
|
||||
_POSIX_C_SOURCE >= 199309L
|
||||
|
|
|
@ -41,7 +41,7 @@ Feature Test Macro Requirements for glibc (see
|
|||
.sp
|
||||
.ad l
|
||||
.BR sigpending ():
|
||||
_POSIX_C_SOURCE\ >=\ 1 || _XOPEN_SOURCE || _POSIX_SOURCE
|
||||
_POSIX_C_SOURCE\ >=\ 1 || _XOPEN_SOURCE
|
||||
.ad b
|
||||
.SH DESCRIPTION
|
||||
.PP
|
||||
|
|
|
@ -42,7 +42,7 @@ Feature Test Macro Requirements for glibc (see
|
|||
.sp
|
||||
.ad l
|
||||
.BR sigprocmask ():
|
||||
_POSIX_C_SOURCE\ >=\ 1 || _XOPEN_SOURCE || _POSIX_SOURCE
|
||||
_POSIX_C_SOURCE\ >=\ 1 || _XOPEN_SOURCE
|
||||
.ad b
|
||||
.SH DESCRIPTION
|
||||
.BR sigprocmask ()
|
||||
|
|
|
@ -41,7 +41,7 @@ Feature Test Macro Requirements for glibc (see
|
|||
.sp
|
||||
.ad l
|
||||
.BR sigsuspend ():
|
||||
_POSIX_C_SOURCE\ >=\ 1 || _XOPEN_SOURCE || _POSIX_SOURCE
|
||||
_POSIX_C_SOURCE\ >=\ 1 || _XOPEN_SOURCE
|
||||
.ad b
|
||||
.SH DESCRIPTION
|
||||
.BR sigsuspend ()
|
||||
|
|
|
@ -41,7 +41,7 @@ Feature Test Macro Requirements for glibc (see
|
|||
.in
|
||||
.sp
|
||||
.BR ctermid ():
|
||||
_POSIX_C_SOURCE\ >=\ 1 || _XOPEN_SOURCE || _POSIX_SOURCE
|
||||
_POSIX_C_SOURCE\ >=\ 1 || _XOPEN_SOURCE
|
||||
.\" From <unistd.h>: _XOPEN_SOURCE
|
||||
.SH DESCRIPTION
|
||||
.BR ctermid ()
|
||||
|
|
|
@ -71,7 +71,7 @@ Feature Test Macro Requirements for glibc (see
|
|||
.BR localtime_r ():
|
||||
.RS
|
||||
_POSIX_C_SOURCE\ >=\ 1 || _XOPEN_SOURCE || _BSD_SOURCE ||
|
||||
_SVID_SOURCE || _POSIX_SOURCE
|
||||
_SVID_SOURCE
|
||||
.RE
|
||||
.ad
|
||||
.SH DESCRIPTION
|
||||
|
|
|
@ -61,7 +61,7 @@ Feature Test Macro Requirements for glibc (see
|
|||
.in
|
||||
.sp
|
||||
.BR fileno ():
|
||||
_POSIX_C_SOURCE\ >=\ 1 || _XOPEN_SOURCE || _POSIX_SOURCE
|
||||
_POSIX_C_SOURCE\ >=\ 1 || _XOPEN_SOURCE
|
||||
.SH DESCRIPTION
|
||||
The function
|
||||
.BR clearerr ()
|
||||
|
|
|
@ -45,7 +45,7 @@ Feature Test Macro Requirements for glibc (see
|
|||
All functions shown above:
|
||||
.RS 4
|
||||
_POSIX_C_SOURCE\ >=\ 1 || _XOPEN_SOURCE || _BSD_SOURCE ||
|
||||
_SVID_SOURCE || _POSIX_SOURCE
|
||||
_SVID_SOURCE
|
||||
.RE
|
||||
.ad b
|
||||
.SH DESCRIPTION
|
||||
|
|
|
@ -61,7 +61,7 @@ Feature Test Macro Requirements for glibc (see
|
|||
.in
|
||||
.sp
|
||||
.BR fdopen ():
|
||||
_POSIX_C_SOURCE\ >=\ 1 || _XOPEN_SOURCE || _POSIX_SOURCE
|
||||
_POSIX_C_SOURCE\ >=\ 1 || _XOPEN_SOURCE
|
||||
.SH DESCRIPTION
|
||||
The
|
||||
.BR fopen ()
|
||||
|
|
|
@ -70,7 +70,7 @@ Feature Test Macro Requirements for glibc (see
|
|||
.BR freeaddrinfo (),
|
||||
.BR gai_strerror ():
|
||||
.RS 4
|
||||
_POSIX_C_SOURCE\ >=\ 1 || _XOPEN_SOURCE || _POSIX_SOURCE
|
||||
_POSIX_C_SOURCE\ >=\ 1 || _XOPEN_SOURCE
|
||||
.RE
|
||||
.ad b
|
||||
.SH DESCRIPTION
|
||||
|
|
|
@ -61,7 +61,7 @@ Feature Test Macro Requirements for glibc (see
|
|||
.BR getgrgid_r ():
|
||||
.RS 4
|
||||
_POSIX_C_SOURCE\ >=\ 1 || _XOPEN_SOURCE || _BSD_SOURCE ||
|
||||
_SVID_SOURCE || _POSIX_SOURCE
|
||||
_SVID_SOURCE
|
||||
.RE
|
||||
.ad b
|
||||
.SH DESCRIPTION
|
||||
|
|
|
@ -27,7 +27,7 @@ Feature Test Macro Requirements for glibc (see
|
|||
.in
|
||||
.sp
|
||||
.BR getnameinfo ():
|
||||
_POSIX_C_SOURCE\ >=\ 1 || _XOPEN_SOURCE || _POSIX_SOURCE
|
||||
_POSIX_C_SOURCE\ >=\ 1 || _XOPEN_SOURCE
|
||||
.ad b
|
||||
.SH DESCRIPTION
|
||||
The
|
||||
|
|
|
@ -65,7 +65,7 @@ Feature Test Macro Requirements for glibc (see
|
|||
.BR getpwuid_r ():
|
||||
.RS 4
|
||||
_POSIX_C_SOURCE\ >=\ 1 || _XOPEN_SOURCE || _BSD_SOURCE ||
|
||||
_SVID_SOURCE || _POSIX_SOURCE
|
||||
_SVID_SOURCE
|
||||
.RE
|
||||
.ad b
|
||||
.SH DESCRIPTION
|
||||
|
|
|
@ -58,7 +58,7 @@ Feature Test Macro Requirements for glibc (see
|
|||
.in
|
||||
.sp
|
||||
.BR rand_r ():
|
||||
_POSIX_C_SOURCE\ >=\ 1 || _XOPEN_SOURCE || _POSIX_SOURCE
|
||||
_POSIX_C_SOURCE\ >=\ 1 || _XOPEN_SOURCE
|
||||
.SH DESCRIPTION
|
||||
The
|
||||
.BR rand ()
|
||||
|
|
|
@ -57,7 +57,7 @@ Feature Test Macro Requirements for glibc (see
|
|||
.BR sigdelset (),
|
||||
.BR sigismember ():
|
||||
.RS 4
|
||||
_POSIX_C_SOURCE\ >=\ 1 || _XOPEN_SOURCE || _POSIX_SOURCE
|
||||
_POSIX_C_SOURCE\ >=\ 1 || _XOPEN_SOURCE
|
||||
.RE
|
||||
.ad b
|
||||
.SH DESCRIPTION
|
||||
|
|
|
@ -40,7 +40,7 @@ Feature Test Macro Requirements for glibc (see
|
|||
.sp
|
||||
.ad l
|
||||
.BR sigwait ():
|
||||
_POSIX_C_SOURCE\ >=\ 1 || _XOPEN_SOURCE || _POSIX_SOURCE
|
||||
_POSIX_C_SOURCE\ >=\ 1 || _XOPEN_SOURCE
|
||||
.ad b
|
||||
.SH DESCRIPTION
|
||||
The
|
||||
|
|
|
@ -49,7 +49,7 @@ Feature Test Macro Requirements for glibc (see
|
|||
.ad l
|
||||
.BR strtok_r ():
|
||||
_SVID_SOURCE || _BSD_SOURCE || _POSIX_C_SOURCE\ >=\ 1 ||
|
||||
_XOPEN_SOURCE || _POSIX_SOURCE
|
||||
_XOPEN_SOURCE
|
||||
.ad b
|
||||
.SH DESCRIPTION
|
||||
The
|
||||
|
|
|
@ -50,10 +50,10 @@ Feature Test Macro Requirements for glibc (see
|
|||
.in
|
||||
.sp
|
||||
.BR tzset ():
|
||||
_POSIX_C_SOURCE\ >=\ 1 || _XOPEN_SOURCE || _POSIX_SOURCE
|
||||
_POSIX_C_SOURCE\ >=\ 1 || _XOPEN_SOURCE
|
||||
.br
|
||||
.IR tzname :
|
||||
_POSIX_C_SOURCE\ >=\ 1 || _XOPEN_SOURCE || _POSIX_SOURCE
|
||||
_POSIX_C_SOURCE\ >=\ 1 || _XOPEN_SOURCE
|
||||
.br
|
||||
.IR timezone :
|
||||
_SVID_SOURCE || _XOPEN_SOURCE
|
||||
|
|
|
@ -73,7 +73,7 @@ Feature Test Macro Requirements for glibc (see
|
|||
.BR putc_unlocked (),
|
||||
.BR putchar_unlocked ():
|
||||
.RS 4
|
||||
_POSIX_C_SOURCE\ >=\ 1 || _XOPEN_SOURCE || _POSIX_SOURCE ||
|
||||
_POSIX_C_SOURCE\ >=\ 1 || _XOPEN_SOURCE ||
|
||||
_BSD_SOURCE || _SVID_SOURCE
|
||||
.RE
|
||||
.sp
|
||||
|
|
|
@ -236,6 +236,10 @@ to the POSIX.1-2008 base specification (excluding the XSI extension).
|
|||
Defining this obsolete macro with any value is equivalent to defining
|
||||
.B _POSIX_C_SOURCE
|
||||
with the value 1.
|
||||
|
||||
Since this macro is obsolete,
|
||||
its usage is generally not documented when discussing
|
||||
feature test macro requirements in the man pages.
|
||||
.TP
|
||||
.B _XOPEN_SOURCE
|
||||
Defining this macro causes header files to expose definitions as follows:
|
||||
|
|
Loading…
Reference in New Issue