diff options
author | Michael Kerrisk <mtk.manpages@gmail.com> | 2014-06-29 08:24:19 +0200 |
---|---|---|
committer | Michael Kerrisk <mtk.manpages@gmail.com> | 2014-06-29 09:49:08 +0200 |
commit | 7905872b285459847220f4c738be59c249680b82 (patch) | |
tree | 3d9c597e02ccd05a3733695fb48a8830a3e2e7da | |
parent | 57598eb1589765cea27e7828d46b2cb56bbb18df (diff) |
printf.3: Remove libc4 and libc5 details
Rich Felker noted that "scare text" in the man page warned about
the use of snprintf() on libc, and that some people had cited
this as a reason not to use snprintf(). Linux libc is now
ancient history, so there is no real need to keep that text.
But, while we're at it, we may as well clear out all of the
other ancient libc4 and libc5 pieces in the page. They are
nowadays more clutter than help.
Reported-by: Rich Felker <dalias@libc.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
-rw-r--r-- | man3/printf.3 | 92 |
1 files changed, 46 insertions, 46 deletions
diff --git a/man3/printf.3 b/man3/printf.3 index 98c0bd28c..743f113d2 100644 --- a/man3/printf.3 +++ b/man3/printf.3 @@ -517,10 +517,10 @@ conversion corresponds to a .I long double argument. (C99 allows %LF, but SUSv2 does not.) -.TP -.B q -("quad". 4.4BSD and Linux libc5 only. -Don't use.) +.\" .TP +.\" .B q +.\" ("quad". 4.4BSD and Linux libc5 only. +.\" Don't use.) This is a synonym for .BR ll . .TP @@ -537,10 +537,10 @@ A following integer conversion corresponds to a or .I ssize_t argument. -(Linux libc5 has -.B Z -with this meaning. -Don't use it.) +.\" (Linux libc5 has +.\" .B Z +.\" with this meaning. +.\" Don't use it.) .TP .B t A following integer conversion corresponds to a @@ -835,31 +835,31 @@ the output string has been large enough. SUSv3 and later align their specification of .BR snprintf () with C99. -.PP -Linux libc4 knows about the five C standard flags. -It knows about the length modifiers \fBh\fP, \fBl\fP, \fBL\fP, -and the conversions -\fBc\fP, \fBd\fP, \fBe\fP, \fBE\fP, \fBf\fP, \fBF\fP, -\fBg\fP, \fBG\fP, \fBi\fP, \fBn\fP, \fBo\fP, \fBp\fP, -\fBs\fP, \fBu\fP, \fBx\fP, and \fBX\fP, -where \fBF\fP is a synonym for \fBf\fP. -Additionally, it accepts \fBD\fP, \fBO\fP, and \fBU\fP as synonyms -for \fBld\fP, \fBlo\fP, and \fBlu\fP. -(This is bad, and caused serious bugs later, when -support for \fB%D\fP disappeared.) -No locale-dependent radix character, -no thousands' separator, no NaN or infinity, no "%m$" and "*m$". -.PP -Linux libc5 knows about the five C standard flags and the \(aq flag, -locale, "%m$" and "*m$". -It knows about the length modifiers \fBh\fP, \fBl\fP, \fBL\fP, -\fBZ\fP, and \fBq\fP, but accepts \fBL\fP and \fBq\fP -both for \fIlong double\fP and for \fIlong long int\fP (this is a bug). -It no longer recognizes \fBF\fP, \fBD\fP, \fBO\fP, and \fBU\fP, -but adds the conversion character -.BR m , -which outputs -.IR strerror(errno) . +.\" .PP +.\" Linux libc4 knows about the five C standard flags. +.\" It knows about the length modifiers \fBh\fP, \fBl\fP, \fBL\fP, +.\" and the conversions +.\" \fBc\fP, \fBd\fP, \fBe\fP, \fBE\fP, \fBf\fP, \fBF\fP, +.\" \fBg\fP, \fBG\fP, \fBi\fP, \fBn\fP, \fBo\fP, \fBp\fP, +.\" \fBs\fP, \fBu\fP, \fBx\fP, and \fBX\fP, +.\" where \fBF\fP is a synonym for \fBf\fP. +.\" Additionally, it accepts \fBD\fP, \fBO\fP, and \fBU\fP as synonyms +.\" for \fBld\fP, \fBlo\fP, and \fBlu\fP. +.\" (This is bad, and caused serious bugs later, when +.\" support for \fB%D\fP disappeared.) +.\" No locale-dependent radix character, +.\" no thousands' separator, no NaN or infinity, no "%m$" and "*m$". +.\" .PP +.\" Linux libc5 knows about the five C standard flags and the \(aq flag, +.\" locale, "%m$" and "*m$". +.\" It knows about the length modifiers \fBh\fP, \fBl\fP, \fBL\fP, +.\" \fBZ\fP, and \fBq\fP, but accepts \fBL\fP and \fBq\fP +.\" both for \fIlong double\fP and for \fIlong long int\fP (this is a bug). +.\" It no longer recognizes \fBF\fP, \fBD\fP, \fBO\fP, and \fBU\fP, +.\" but adds the conversion character +.\" .BR m , +.\" which outputs +.\" .IR strerror(errno) . .PP glibc 2.0 adds conversion characters \fBC\fP and \fBS\fP. .PP @@ -947,19 +947,19 @@ instead (or .BR asprintf (3) and .BR vasprintf (3)). -.PP -Linux libc4.[45] does not have a -.BR snprintf (), -but provides a libbsd that contains an -.BR snprintf () -equivalent to -.BR sprintf (), -that is, one that ignores the -.I size -argument. -Thus, the use of -.BR snprintf () -with early libc4 leads to serious security problems. +.\" .PP +.\" Linux libc4.[45] does not have a +.\" .BR snprintf (), +.\" but provides a libbsd that contains an +.\" .BR snprintf () +.\" equivalent to +.\" .BR sprintf (), +.\" that is, one that ignores the +.\" .I size +.\" argument. +.\" Thus, the use of +.\" .BR snprintf () +.\" with early libc4 leads to serious security problems. .PP Code such as .BI printf( foo ); |