fuse.4: ffix

[thirdparty/man-pages.git] / man3 / ecvt.3

diff --git a/man3/ecvt.3 b/man3/ecvt.3
index ea5af2efe1d9ccefc2eb42482ad264d0f6456147..637112cf45b04f2328953e41ec6adefe72ad7e71 100644 (file)
--- a/man3/ecvt.3
+++ b/man3/ecvt.3
@@ -1,5 +1,6 @@
 .\" Copyright 1993 David Metcalfe (david@prism.demon.co.uk)
 .\"
+.\" %%%LICENSE_START(VERBATIM)
 .\" Permission is granted to make and distribute verbatim copies of this
 .\" manual provided the copyright notice and this permission notice are
 .\" preserved on all copies.
@@ -19,6 +20,7 @@
 .\"
 .\" Formatted or processed versions of this manual, if unaccompanied by
 .\" the source, must acknowledge the copyright and authors of this work.
+.\" %%%LICENSE_END
 .\"
 .\" References consulted:
 .\"     Linux libc source code
@@ -27,26 +29,42 @@
 .\" Modified Sat Jul 24 19:40:39 1993 by Rik Faith (faith@cs.unc.edu)
 .\" Modified Fri Jun 25 12:10:47 1999 by Andries Brouwer (aeb@cwi.nl)
 .\"
-.TH ECVT 3  2007-07-26 "" "Linux Programmer's Manual"
+.TH ECVT 3 2016-03-15 "" "Linux Programmer's Manual"
 .SH NAME
 ecvt, fcvt \- convert a floating-point number to a string
 .SH SYNOPSIS
 .B #include <stdlib.h>
-.sp
+.PP
 .BI "char *ecvt(double " number ", int " ndigits ", int *" decpt ,
 .BI "int *" sign );
-.sp
+.PP
 .BI "char *fcvt(double " number ", int " ndigits ", int *" decpt ,
 .BI "int *" sign );
-.sp
+.PP
 .in -4n
 Feature Test Macro Requirements for glibc (see
 .BR feature_test_macros (7)):
 .in
-.sp
+.PP
 .BR ecvt (),
 .BR fcvt ():
+.ad l
+.RS 4
+.PD 0
+.TP 4
+Since glibc 2.12:
+.nf
+(_XOPEN_SOURCE\ >=\ 500) ! (_POSIX_C_SOURCE\ >=\ 200112L)
+    || /* Glibc since 2.19: */ _DEFAULT_SOURCE
+    || /* Glibc versions <= 2.19: */ _SVID_SOURCE
+.fi
+.TP 4
+Before glibc 2.12:
 _SVID_SOURCE || _XOPEN_SOURCE\ >=\ 500
+.\"    || _XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED
+.PD
+.RE
+.ad b
 .SH DESCRIPTION
 The
 .BR ecvt ()
@@ -55,7 +73,7 @@ string of \fIndigits\fP digits (where \fIndigits\fP is reduced to a
 system-specific limit determined by the precision of a
 .IR double ),
 and returns a pointer to the string.
-The high-order digit is non-zero, unless
+The high-order digit is nonzero, unless
 .I number
 is zero.
 The low order digit is rounded.
@@ -65,7 +83,7 @@ is stored in \fI*decpt\fP.
 A negative value for \fI*decpt\fP means that
 the decimal point is to the left of the start of the string.
 If the sign of
-\fInumber\fP is negative, \fI*sign\fP is set to a non-zero value,
+\fInumber\fP is negative, \fI*sign\fP is set to a nonzero value,
 otherwise it is set to 0.
 If
 .I number
@@ -77,7 +95,7 @@ function is identical to
 .BR ecvt (),
 except that
 \fIndigits\fP specifies the number of digits after the decimal point.
-.SH "RETURN VALUE"
+.SH RETURN VALUE
 Both the
 .BR ecvt ()
 and
@@ -88,20 +106,40 @@ The static string is overwritten by each call to
 .BR ecvt ()
 or
 .BR fcvt ().
-.SH "CONFORMING TO"
+.SH ATTRIBUTES
+For an explanation of the terms used in this section, see
+.BR attributes (7).
+.TS
+allbox;
+lb lb lb
+l l l.
+Interface      Attribute       Value
+T{
+.BR ecvt ()
+T}     Thread safety   MT-Unsafe race:ecvt
+T{
+.BR fcvt ()
+T}     Thread safety   MT-Unsafe race:fcvt
+.TE
+.SH CONFORMING TO
 SVr2;
 marked as LEGACY in POSIX.1-2001.
-.SH NOTES
-These functions are obsolete.
-Instead,
+POSIX.1-2008 removes the specifications of
+.BR ecvt ()
+and
+.BR fcvt (),
+recommending the use of
 .BR sprintf (3)
-is recommended.
-Linux libc4 and libc5 specified the type of
-.I ndigits
-as
-.IR size_t .
+instead (though
+.BR snprintf (3)
+may be preferable).
+.SH NOTES
+.\" Linux libc4 and libc5 specified the type of
+.\" .I ndigits
+.\" as
+.\" .IR size_t .
 Not all locales use a point as the radix character ("decimal point").
-.SH "SEE ALSO"
+.SH SEE ALSO
 .BR ecvt_r (3),
 .BR gcvt (3),
 .BR qecvt (3),