alloca: one step towards thread-safety
[pspp] / lib / ftoastr.h
index 4c4f890cd2619736c573b23bc586325e30e29089..c16a884f2bee36df45c2ec3abcf01496857bbc0f 100644 (file)
@@ -26,8 +26,8 @@
 /* Store into BUF (of size BUFSIZE) an accurate minimal-precision
    string representation of a floating point number.  FLAGS affect the
    formatting of the number.  Pad the output string with spaces as
-   necessary to width WIDTH bytes, in the style of printf.  X is the
-   floating-point number to be converted.
+   necessary to width WIDTH bytes, in the style of printf.  WIDTH must
+   be nonnegative.  X is the floating-point number to be converted.
 
    Return the number of bytes stored into BUF, not counting the
    terminating null.  However, do not overrun BUF: if BUF is too
@@ -39,8 +39,8 @@
 
    Example:
 
-     char buf[DBL_ABUFSIZE_BOUND];
-     int r = dtoastr (buf, sizeof buf, "%*.*g", 0, 0.1);
+     char buf[DBL_BUFSIZE_BOUND];
+     int r = dtoastr (buf, sizeof buf, 0, 0, 0.1);
 
    In the C locale, this sets R to 3 and stores "0.1" into BUF.  */