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:
Michael Kerrisk 2016-02-12 17:11:05 +01:00
parent c4a256e267
commit c1016e8767
21 changed files with 25 additions and 21 deletions

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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 ()

View File

@ -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 ()

View File

@ -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 ()

View File

@ -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

View File

@ -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 ()

View File

@ -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

View File

@ -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 ()

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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 ()

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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: