Re: RFC: man-page for strfrom functions

["Michael Kerrisk (man-pages)" <mtk.manpages-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org>]

Hello Wainer,

On 11/30/2016 08:22 PM, Wainer S. Moschetta wrote:
> Hi all,
> 
> The strfrom class of functions convert a floating-point value into
> string. It is recently introduced in Glibc (see commit 6962682ffe5e)
> and will be in version 2.25.
> 
> I've prepared a patch to add strfrom.3 in the man-pages but I'd like
> to discuss a point for the contribution beforehand:
> 
> - strfrom* is similar to snprintf() except for the format string. For
> instance, it doesn't have the length modifier and accept just a
> subset of conversion specifiers.
> 
> That said, I've doubt if wouldn't be better to place strfrom
> documentation at snprintf man-page (which is actually printf's)
> rather than on its own page.

Thanks. It would be great to get this documentation!

My estimation is that these functions would be better on their 
own page, rather than in printf(3). The strfrom*() functions 
provide only a subset of what snprintf(), and I think embedding
the description of strfrom*() in printf() means they'd be a bit
lost in among all the rest of the text.

Cheers,

Michael

-- 
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
Linux/UNIX System Programming Training: http://man7.org/training/
--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html