* [PATCH] trivial: make comment about vs{n,cn,}printf more understandable
@ 2010-11-23 16:12 Uwe Kleine-König
2010-11-24 3:04 ` Milton Miller
0 siblings, 1 reply; 7+ messages in thread
From: Uwe Kleine-König @ 2010-11-23 16:12 UTC (permalink / raw)
To: linux-kernel; +Cc: trivial, Steven Rostedt, Will Schmidt
"You probably want ... instead." sounds like a recommendation better
not to use the v... functions.
Signed-off-by: Uwe Kleine-König <u.kleine-koenig@pengutronix.de>
---
lib/vsprintf.c | 9 +++------
1 files changed, 3 insertions(+), 6 deletions(-)
diff --git a/lib/vsprintf.c b/lib/vsprintf.c
index c150d3d..ec43171 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 better use 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 better use 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 better use sprintf().
*
* See the vsnprintf() documentation for format string extensions over C99.
*/
--
1.7.2.3
^ permalink raw reply related [flat|nested] 7+ messages in thread
* Re: trivial: make comment about vs{n,cn,}printf more understandable
2010-11-23 16:12 [PATCH] trivial: make comment about vs{n,cn,}printf more understandable Uwe Kleine-König
@ 2010-11-24 3:04 ` Milton Miller
2010-11-24 3:20 ` Steven Rostedt
2010-11-24 19:10 ` [PATCH v2] " Uwe Kleine-König
0 siblings, 2 replies; 7+ messages in thread
From: Milton Miller @ 2010-11-24 3:04 UTC (permalink / raw)
To: u.kleine-koenig
Cc: linux-kernel, trivial, Steven Rostedt, Will Schmidt, Randy Dunlap
[-- Warning: decoded text below may be mangled, UTF-8 assumed --]
[-- Attachment #1: Type: text/plain, Size: 842 bytes --]
On Tue, 23 Nov 2010 at about 16:12:45 -0000, Uwe Kleine-König wrote:
>
> "You probably want ... instead." sounds like a recommendation better
> not to use the v... functions.
>
Which is true, if you dont' have a va_list its hard to get them.
But I do get your point.
> * 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 better use scnprintf().
That doesn't flow off my (mid-western usa) tounge.
How about
* Call this function if you are already dealing with a va_list.
* Otherwise you probably want to use scnprintf().
Alternatively,
* If you're not already dealing with a va_list consider scnprintf().
Thanks,
milton
^ permalink raw reply [flat|nested] 7+ messages in thread
* Re: trivial: make comment about vs{n,cn,}printf more understandable
2010-11-24 3:04 ` Milton Miller
@ 2010-11-24 3:20 ` Steven Rostedt
2010-11-24 15:27 ` Will Schmidt
2010-11-24 19:10 ` [PATCH v2] " Uwe Kleine-König
1 sibling, 1 reply; 7+ messages in thread
From: Steven Rostedt @ 2010-11-24 3:20 UTC (permalink / raw)
To: Milton Miller
Cc: u.kleine-koenig, linux-kernel, trivial, Will Schmidt, Randy Dunlap
On Tue, 2010-11-23 at 21:04 -0600, Milton Miller wrote:
> On Tue, 23 Nov 2010 at about 16:12:45 -0000, Uwe Kleine-König wrote:
> >
> > "You probably want ... instead." sounds like a recommendation better
> > not to use the v... functions.
> >
>
> Which is true, if you dont' have a va_list its hard to get them.
> But I do get your point.
>
> > * 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 better use scnprintf().
>
> That doesn't flow off my (mid-western usa) tounge.
>
> How about
> * Call this function if you are already dealing with a va_list.
> * Otherwise you probably want to use scnprintf().
This is closer to what he asked us on IRC ;-)
But a "do X if Y" is more perl syntax than English (IMHO).
>
> Alternatively,
> * If you're not already dealing with a va_list consider scnprintf().
This isn't bad. My recommendation I gave him was:
* If you are already dealing with a va_list, then call this function.
* Otherwise you probably want to use scnprintf()
But my upstate NY tongue may not be the best judgment here.
-- Steve
"When people ask me what language my mother tongue is, I simply reply 'C'"
^ permalink raw reply [flat|nested] 7+ messages in thread
* Re: trivial: make comment about vs{n,cn,}printf more understandable
2010-11-24 3:20 ` Steven Rostedt
@ 2010-11-24 15:27 ` Will Schmidt
0 siblings, 0 replies; 7+ messages in thread
From: Will Schmidt @ 2010-11-24 15:27 UTC (permalink / raw)
Cc: Milton Miller, u.kleine-koenig, linux-kernel, trivial,
Randy Dunlap, Steven Rostedt
On Tue, 2010-11-23 at 22:20 -0500, Steven Rostedt wrote:
> On Tue, 2010-11-23 at 21:04 -0600, Milton Miller wrote:
> > On Tue, 23 Nov 2010 at about 16:12:45 -0000, Uwe Kleine-König wrote:
> > >
> > > "You probably want ... instead." sounds like a recommendation better
> > > not to use the v... functions.
> > >
> >
> > Which is true, if you dont' have a va_list its hard to get them.
> > But I do get your point.
> >
> > > * 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 better use scnprintf().
> >
> > That doesn't flow off my (mid-western usa) tounge.
> >
> > How about
> > * Call this function if you are already dealing with a va_list.
> > * Otherwise you probably want to use scnprintf().
> This is closer to what he asked us on IRC ;-)
>
> But a "do X if Y" is more perl syntax than English (IMHO).
>
>
> >
> > Alternatively,
> > * If you're not already dealing with a va_list consider scnprintf().
>
> This isn't bad. My recommendation I gave him was:
>
> * If you are already dealing with a va_list, then call this function.
> * Otherwise you probably want to use scnprintf()
Would be nice if we could lead with the "probably...", but I don't see a
clean way of doing that. How about a blending of the two:
* Call this function if you are dealing with a va_list, otherwise use
the scnprintf() function.
> But my upstate NY tongue may not be the best judgment here.
>
> -- Steve
>
> "When people ask me what language my mother tongue is, I simply reply 'C'"
>
>
>
^ permalink raw reply [flat|nested] 7+ messages in thread
* [PATCH v2] trivial: make comment about vs{n,cn,}printf more understandable
2010-11-24 3:04 ` Milton Miller
2010-11-24 3:20 ` Steven Rostedt
@ 2010-11-24 19:10 ` Uwe Kleine-König
2011-04-06 14:34 ` Uwe Kleine-König
1 sibling, 1 reply; 7+ messages in thread
From: Uwe Kleine-König @ 2010-11-24 19:10 UTC (permalink / raw)
To: linux-kernel
Cc: trivial, Steven Rostedt, Will Schmidt, Randy Dunlap, Milton Miller
"You probably want ... instead." sounds like a recommendation better
not to use the v... functions.
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
^ permalink raw reply related [flat|nested] 7+ messages in thread
* Re: [PATCH v2] trivial: make comment about vs{n,cn,}printf more understandable
2010-11-24 19:10 ` [PATCH v2] " Uwe Kleine-König
@ 2011-04-06 14:34 ` Uwe Kleine-König
2011-04-06 14:37 ` Jiri Kosina
0 siblings, 1 reply; 7+ messages in thread
From: Uwe Kleine-König @ 2011-04-06 14:34 UTC (permalink / raw)
To: Jiri Kosina
Cc: linux-kernel, Steven Rostedt, Will Schmidt, Randy Dunlap, Milton Miller
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/ |
^ permalink raw reply [flat|nested] 7+ messages in thread
* Re: [PATCH v2] trivial: make comment about vs{n,cn,}printf more understandable
2011-04-06 14:34 ` Uwe Kleine-König
@ 2011-04-06 14:37 ` Jiri Kosina
0 siblings, 0 replies; 7+ messages in thread
From: Jiri Kosina @ 2011-04-06 14:37 UTC (permalink / raw)
To: Uwe Kleine-König
Cc: linux-kernel, Steven Rostedt, Will Schmidt, Randy Dunlap, Milton Miller
On Wed, 6 Apr 2011, Uwe Kleine-König wrote:
> 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?
Hi,
I don't see it in the trivial 'todo' queue. Either I though someone else
is taking it, or I just missed it. Could you please re-bounce it to
trivial@kernel.org, and I will apply it?
Thanks.
>
> 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/ |
>
--
Jiri Kosina
SUSE Labs, Novell Inc.
^ permalink raw reply [flat|nested] 7+ messages in thread
end of thread, other threads:[~2011-04-06 14:37 UTC | newest]
Thread overview: 7+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2010-11-23 16:12 [PATCH] trivial: make comment about vs{n,cn,}printf more understandable Uwe Kleine-König
2010-11-24 3:04 ` Milton Miller
2010-11-24 3:20 ` Steven Rostedt
2010-11-24 15:27 ` Will Schmidt
2010-11-24 19:10 ` [PATCH v2] " Uwe Kleine-König
2011-04-06 14:34 ` Uwe Kleine-König
2011-04-06 14:37 ` Jiri Kosina
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).