Re: [PATCH v2] trivial: make comment about vs{n,cn,}printf more understandable

["Uwe Kleine-König" <u.kleine-koenig@pengutronix.de>]

Hello Jiri,

On Wed, Nov 24, 2010 at 08:10:33PM +0100, Uwe Kleine-König wrote:
> "You probably want ... instead." sounds like a recommendation better
> not to use the v... functions.
you didn't take this patch. Did you skip it on purpose?

Best regards
Uwe

> 
> Signed-off-by: Uwe Kleine-König <u.kleine-koenig@pengutronix.de>
> ---
> Hello,
> 
> this is Milton's alternative suggestion plus an added "using".
> 
> Thanks
> Uwe
> 
>  lib/vsprintf.c |    9 +++------
>  1 files changed, 3 insertions(+), 6 deletions(-)
> 
> diff --git a/lib/vsprintf.c b/lib/vsprintf.c
> index c150d3d..6c46e0f 100644
> --- a/lib/vsprintf.c
> +++ b/lib/vsprintf.c
> @@ -1279,8 +1279,7 @@ qualifier:
>   * return is greater than or equal to @size, the resulting
>   * string is truncated.
>   *
> - * Call this function if you are already dealing with a va_list.
> - * You probably want snprintf() instead.
> + * If you're not already dealing with a va_list consider using snprintf().
>   */
>  int vsnprintf(char *buf, size_t size, const char *fmt, va_list args)
>  {
> @@ -1454,8 +1453,7 @@ EXPORT_SYMBOL(vsnprintf);
>   * the @buf not including the trailing '\0'. If @size is <= 0 the function
>   * returns 0.
>   *
> - * Call this function if you are already dealing with a va_list.
> - * You probably want scnprintf() instead.
> + * If you're not already dealing with a va_list consider using scnprintf().
>   *
>   * See the vsnprintf() documentation for format string extensions over C99.
>   */
> @@ -1534,8 +1532,7 @@ EXPORT_SYMBOL(scnprintf);
>   * into @buf. Use vsnprintf() or vscnprintf() in order to avoid
>   * buffer overflows.
>   *
> - * Call this function if you are already dealing with a va_list.
> - * You probably want sprintf() instead.
> + * If you're not already dealing with a va_list consider using sprintf().
>   *
>   * See the vsnprintf() documentation for format string extensions over C99.
>   */
> -- 
> 1.7.2.3
> 
> 

-- 
Pengutronix e.K.                           | Uwe Kleine-König            |
Industrial Linux Solutions                 | http://www.pengutronix.de/  |