Commit Graph

5289 Commits

Author SHA1 Message Date
Michael Kerrisk 97ff735155 tmpnam.3: Remove mention od _BSD_SOURCE and _SVID_SOURCE
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-01 20:01:04 +01:00
Michael Kerrisk 6b8b0e500c strtok.3: grfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-01 20:01:04 +01:00
Michael Kerrisk 9db90c7cc9 getgrent.3, getgrnam.3, getpwent.3, getpwnam.3: Updaye FTM requirements (mostly _DEFAULT_SOURCE)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-01 20:01:04 +01:00
Michael Kerrisk c1016e8767 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>
2016-03-01 20:01:04 +01:00
Michael Kerrisk c4a256e267 strerror.3: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-01 20:01:04 +01:00
Michael Kerrisk a30128b4cc dirfd.3, readdir.3, scandir.3, seekdir.3, telldir.3: Update FTM requirements (mostly _DEFAULT_SOURCE)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-01 20:01:04 +01:00
Michael Kerrisk 2b1b042487 a64l.3, atoi.3, clearenv.3, drand48.3, drand48_r.3, ecvt.3, ecvt_r.3, gcvt.3, mkstemp.3, mktemp.3, posix_memalign.3, putenv.3, random.3, random_r.3, realpath.3, setenv.3, strtol.3, strtoul.3: Update FTM requirements (mostly _DEFAULT_SOURCE)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-01 20:01:04 +01:00
Michael Kerrisk 6e0869f758 getcwd.3, getdtablesize.3, getpass.3, lockf.3, ualarm.3, usleep.3: Update FTM requirements (mainly _DEFAULT_SOURCE)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-01 20:01:04 +01:00
Michael Kerrisk e0a68e13d9 acosh.3, asinh.3, atanh.3: Update FTM requirements (_DEFAULT_SOURCE)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-01 20:01:04 +01:00
Michael Kerrisk 827cdae3f1 _exit.2, abs.3, acos.3, acosh.3, asin.3, asinh.3, atan.3, atan2.3, atanh.3, atoi.3, cbrt.3, ceil.3, copysign.3, cos.3, cosh.3, div.3, erf.3, erfc.3, exp.3, exp2.3, expm1.3, fabs.3, fdim.3, finite.3, floor.3, fma.3, fmax.3, fmin.3, fmod.3, fpclassify.3, frexp.3, fwide.3, hypot.3, ilogb.3, isalpha.3, isgreater.3, iswblank.3, ldexp.3, lgamma.3, log.3, log10.3, log1p.3, log2.3, logb.3, lrint.3, lround.3, modf.3, nan.3, nextafter.3, pow.3, printf.3, remainder.3, remquo.3, rint.3, round.3, scalbln.3, scanf.3, signbit.3, sin.3, sinh.3, sqrt.3, strtod.3, strtol.3, strtoul.3, tan.3, tanh.3, tgamma.3, trunc.3, wprintf.3: Remove "or 'cc -std=c99'" from SYNOPSIS
Under the FTM requirements all of these pages document the
requirement for _ISOC99_SOURCE. And feature_test_macros(7) now
documents that "cc -std=c99" produces the same effect as defining
_ISOC99_SOURCE. So, all of these pages don't additionally need
to specify "or 'cc -std=c99'" under the FTM requirements
in the SYNOPSIS. Removing that redundant text also simplifies
the SYNOPSIS a little.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-01 20:01:04 +01:00
Michael Kerrisk cd2d5ec163 exp2.3, finite.3, fwide.3, log2.3, nextafter.3, printf.3, rint.3, wprintf.3: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-01 20:01:04 +01:00
Michael Kerrisk 636ed4d58d acosh.3, asinh.3, atanh.3, cbrt.3, erf.3, erfc.3, expm1.3, fpclassify.3, gamma.3, hypot.3, ilogb.3, j0.3, lgamma.3, log1p.3, logb.3, matherr.3, nextafter.3, remainder.3, rint.3, scalb.3, scalbln.3, significand.3, y0.3: Update FTM requirements (_DEFAULT_SOURCE)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-01 20:01:04 +01:00
Michael Kerrisk e9d91bcf4c acos.3, asin.3, atan.3, atan2.3, ceil.3, copysign.3, cos.3, cosh.3, exp.3, fabs.3, floor.3, fmod.3, frexp.3, ldexp.3, log.3, log10.3, modf.3, pow.3, sin.3, sinh.3, sqrt.3, tan.3, tanh.3: Update FTM requirements (_DEFAULT_SOURCE)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-01 20:01:04 +01:00
Michael Kerrisk aa573adabf dirfd.3: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-01 20:01:03 +01:00
Michael Kerrisk 51c612fb9f getgroups.2, gettimeofday.2, mincore.2, readv.2, stime.2, wait4.2, addseverity.3, adjtime.3, cfree.3, dysize.3, fgetgrent.3, fgetpwent.3, futimes.3, getdirentries.3, getgrent_r.3, getgrouplist.3, getmntent.3, getnetent_r.3, getprotoent_r.3, getpwent_r.3, getrpcent_r.3, getservent_r.3, getspnam.3, gsignal.3, initgroups.3, mkdtemp.3, on_exit.3, perror.3, psignal.3, putpwent.3, rcmd.3, rpmatch.3, setbuf.3, setnetgrent.3, sigvec.3, strsep.3, syslog.3, tempnam.3, termios.3, timegm.3, timeradd.3: Update FTM requirements (_DEFAULT_SOURCE)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-01 20:01:03 +01:00
Michael Kerrisk 3dd87b7c99 setjmp.3: Remove reference to obsolete _XOPEN_SOURCE_EXTENDED
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-01 20:01:03 +01:00
Michael Kerrisk b40ec4cbf8 ttyslot.3: Update FTM requirements (_DEFAULT_SOURCE)
And remove mention of obsolete _XOPEN_SOURCE_EXTENDED

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-01 20:01:03 +01:00
Michael Kerrisk cf7fa0a179 brk.2, chdir.2, chmod.2, chown.2, chroot.2, getpagesize.2, getsid.2, killpg.2, mknod.2, readlink.2, setpgid.2, setreuid.2, sigaltstack.2, stat.2, symlink.2, sync.2, truncate.2, vfork.2, wait.2, wait4.2, a64l.3, acosh.3, asinh.3, atanh.3, cbrt.3, ecvt.3, expm1.3, gcvt.3, getcwd.3, getdate.3, getdtablesize.3, getgrent.3, gethostid.3, getpass.3, getpwent.3, getsubopt.3, ilogb.3, insque.3, lockf.3, log1p.3, logb.3, mkstemp.3, mktemp.3, nextafter.3, posix_memalign.3, random.3, realpath.3, remainder.3, rint.3, scalb.3, siginterrupt.3, sigset.3, strdup.3, ualarm.3, usleep.3: Remove references to _XOPEN_SOURCE_EXTENDED in SYNOPSIS
_XOPEN_SOURCE_EXTENDED is obsolete (it existed in SUSv1, but not
subsequent standards). _XOPEN_SOURCE >= 500 produces the same
effects as (_XOPEN_SOURCE && _XOPEN_SOURCE_EXTENDED). Modifying
the SYNOPSIS of various ages that contain:

    _XOPEN_SOURCE\ >=\ 500 ||
        _XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED

to just:

    _XOPEN_SOURCE\ >=\ 500

This has the following benefits:

a) Simplifying the SYNOPSIS by removing ancient
   historical information.

b) Preventing users from being misled into using
   _XOPEN_SOURCE_EXTENDED in new source code.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-01 20:01:03 +01:00
Michael Kerrisk 7f0ec8eed6 endian.3, getloadavg.3, getutent.3, inet.3, makedev.3, rexec.3: Update FTM requirements (_DEFAULT_SOURCE)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-01 20:01:03 +01:00
Michael Kerrisk e1d0532862 scandir.3: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-01 20:01:03 +01:00
Michael Kerrisk b0da7b8b76 access.2, chmod.2, chown.2, link.2, mkdir.2, open.2, readlink.2, rename.2, stat.2, symlink.2, unlink.2, utimensat.2, vfork.2, dirfd.3, fexecve.3, ffs.3, fmemopen.3, getcwd.3, gethostbyname.3, getline.3, mbsnrtowcs.3, mkdtemp.3, mkfifo.3, opendir.3, printf.3, psignal.3, qecvt.3, scandir.3, stpcpy.3, stpncpy.3, strdup.3, strnlen.3, strsignal.3, ualarm.3, usleep.3, wcpcpy.3, wcpncpy.3, wcscasecmp.3, wcsdup.3, wcsncasecmp.3, wcsnlen.3, wcsnrtombs.3: Simply FTM requirements
Looking at <features.h> (or feature_test_macros(7)), one can
see that when _XOPEN_SOURCE is defined with the value 700
(or greater), then _POSIX_C_SOURCE is defined with the value
200809L (or greater). Therefore, terms in the man pages such as

    _XOPEN_SOURCE\ >=\ 700 || _POSIX_C_SOURCE\ >=\ 200809L

can be simpified to:

    _POSIX_C_SOURCE\ >=\ 200809L

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-01 20:01:03 +01:00
Michael Kerrisk e464f0546d _exit.2, brk.2, abs.3, acos.3, acosh.3, asin.3, asinh.3, atan.3, atan2.3, atanh.3, atoi.3, cbrt.3, ceil.3, copysign.3, cos.3, cosh.3, div.3, erf.3, erfc.3, exp.3, expm1.3, fabs.3, fdim.3, floor.3, fma.3, fmax.3, fmin.3, fmod.3, fpclassify.3, frexp.3, hypot.3, ilogb.3, isalpha.3, isgreater.3, iswblank.3, ldexp.3, lgamma.3, log.3, log10.3, log1p.3, logb.3, lrint.3, lround.3, modf.3, nan.3, nextafter.3, posix_memalign.3, pow.3, remainder.3, remquo.3, round.3, scalbln.3, scanf.3, signbit.3, sin.3, sinh.3, sqrt.3, strtod.3, strtol.3, strtoul.3, tan.3, tanh.3, tgamma.3, trunc.3: Simplify FTM requirements
Looking at <features.h> (or feature_test_macros(7)), one can
see that when _XOPEN_SOURCE is defined with the value 600
(or greater), then _POSIX_C_SOURCE is defined with the value
200112L (or greater). Therefore, terms in the man pages such as

    _XOPEN_SOURCE\ >=\ 600 || _POSIX_C_SOURCE\ >=\ 200112L

can be simplified to:

    _POSIX_C_SOURCE\ >=\ 200112L

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>`

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-01 20:01:03 +01:00
Michael Kerrisk a446ac0c68 brk.2, chroot.2, clock_nanosleep.2, getpagesize.2, posix_fadvise.2, select.2, select_tut.2, seteuid.2, clock_getcpuclockid.3, ecvt.3, exp2.3, fseeko.3, gcvt.3, getdtablesize.3, getpass.3, getw.3, log2.3, mktemp.3, mq_receive.3, mq_send.3, posix_fallocate.3, posix_madvise.3, posix_memalign.3, pthread_attr_setstack.3, rint.3, sem_wait.3, setenv.3, sockatmark.3, strerror.3: Simplify FTM requirements
Looking at <features.h> (or feature_test_macros(7)), one can
see that when _XOPEN_SOURCE is defined with the value 600
(or greater), then _POSIX_C_SOURCE is defined with the value
200112L (or greater). Therefore, terms in the man pages such as

    _XOPEN_SOURCE\ >=\ 600 || _POSIX_C_SOURCE\ >=\ 200112L

can be simpified to:

    _POSIX_C_SOURCE\ >=\ 200112L

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-01 20:01:03 +01:00
Michael Kerrisk d054453419 acct.2, getdomainname.2, gethostname.2, vhangup.2, daemon.3, gethostid.3, getusershell.3, profil.3: Update feature test macro requirements
Update to use _DEFAULT_SOURCE, and also changes brought by
glibc commit 266865c0e7b79d4196e2cc393693463f03c90bd8.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-01 20:01:03 +01:00
Michael Kerrisk b105252461 readdir.3: Reorder text describing readdir_r()
(This is done in preparation for discussing glibc 2.23 changes.)

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-01 11:01:27 +01:00
Michael Kerrisk 119cb943f0 readdir.3: srcfix: add missing 2008 copyright note
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-01 11:01:27 +01:00
Michael Kerrisk cefcfd92d5 backtrace.3: Minor reworking in example program
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-01 11:01:27 +01:00
Jakub Wilk 40da0793a6 getaddrinfo.3: tfix
Signed-off-by: Jakub Wilk <jwilk@jwilk.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-28 14:39:01 +01:00
Michael Kerrisk a222234619 backtrace.3: Small fixes to example program
Reported-by: Martin Gebert <Murphy.Gebert@gmx.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-26 16:45:17 +01:00
Michael Kerrisk 271ee1bf63 termios.3: SEE ALSO: add tty(1)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-26 13:20:09 +01:00
Michael Kerrisk 23ec905b42 setbuf.3: SEE ALSO: add stdbuf(1)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-26 12:58:44 +01:00
Michael Kerrisk 9bfa6a8427 sleep.3: SEE ALSO: add sleep(1)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-26 12:32:13 +01:00
Michael Kerrisk b936906ac9 getcwd.3: SEE ALSO: add pwd(1)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-26 12:30:10 +01:00
Michael Kerrisk 06cdf61aca fts.3: BUGS: glibc-2.23 now has LFS support for the fts functions
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-22 09:21:45 +01:00
Michael Kerrisk c66649c835 clearenv.3: Clarify the use and effect of clearenv()
See http://bugs.debian.org/679323

Reported-by: Matt Zimmerman <mdz@debian.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-19 13:07:58 +01:00
Michael Kerrisk e44a70d63b clearenv.3: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-19 13:07:58 +01:00
Michael Kerrisk f34269b6ed clearenv.3: Variables can be added to the environment after calling clearenv()
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-19 13:07:58 +01:00
Michael Kerrisk e8f9c18c31 clearenv.3: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-19 13:07:57 +01:00
Michael Kerrisk d2229a2b2f clog10.3: Show an alternative equivalence for clog10()
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-19 13:07:57 +01:00
Michael Kerrisk d8334b03a5 clog10.3: Update CONFORMING TO
Fix grammar error and add C11.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-19 13:07:57 +01:00
Michael Kerrisk 5c6de1fc37 strnlen.3: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-18 14:17:29 +01:00
Michael Kerrisk 5af40309cc strlen.3: CONFORMING TO: add C11
Reported-by: Alan Aversa <alan.aversa@cox.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-18 14:10:15 +01:00
Michael Kerrisk b357f2c97c strlen.3: wfix
Reported-by: Alan Aversa <alan.aversa@cox.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-18 14:09:49 +01:00
Michael Kerrisk 2ddb74c035 strlen.3: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-18 13:27:02 +01:00
Michael Kerrisk 988c4c4263 termios.3: Further improvements to recent tweaks of canonical mode 4096 char limit
Reported-by: Peter Hurley <peter@hurleysoftware.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-18 12:23:21 +01:00
Michael Kerrisk 4a66305922 printf.3: tfix
See https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=756599

Reported-by: Jakub Wilk <jwilk@debian.org>
Reported-by: Stéphane Aulery <lkppo@free.fr>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-17 13:10:37 +01:00
Michael Kerrisk 332aaf19ff setjmp.3: wfix
Reported-by: Stephan Bergmann <sbergman@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-17 12:08:38 +01:00
Michael Kerrisk 082efcce8b signal.7: Note the interactions of longjmp() and non-async-signal-safe functions
See http://austingroupbugs.net/view.php?id=516#c1195.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-16 15:48:36 +01:00
Michael Kerrisk f1d6ee6211 setjmp.3: Note the interactions of longjmp() and non-async-signal-safe functions
POSIX.1-2008 TC2 adds explicit text on this point.
See http://austingroupbugs.net/view.php?id=516#c1195

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-16 15:48:36 +01:00
Michael Kerrisk b51ef507b8 longjmp.3: Replace page with link to setjmp(3), which now incorporates longjmp()
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-02-16 15:48:36 +01:00