[src/trunk]: src/lib/libc/time Note briefly how to avoid the problem where 0 ...

[dholland <dholland%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/1cc5d31cd92c
branches:  trunk
changeset: 755241:1cc5d31cd92c
user:      dholland <dholland%NetBSD.org@localhost>
date:      Sat May 29 20:32:18 2010 +0000

description:
Note briefly how to avoid the problem where 0 can be a valid successful
return as well as an error. Suggested by Robert Elz in follow up to PR 39392.

diffstat:

 lib/libc/time/strftime.3 |  7 +++++--
 1 files changed, 5 insertions(+), 2 deletions(-)

diffs (22 lines):

diff -r 7dafefffbf1f -r 1cc5d31cd92c lib/libc/time/strftime.3
--- a/lib/libc/time/strftime.3  Sat May 29 18:55:34 2010 +0000
+++ b/lib/libc/time/strftime.3  Sat May 29 20:32:18 2010 +0000
@@ -30,9 +30,9 @@
 .\" SUCH DAMAGE.
 .\"
 .\"     from: @(#)strftime.3   5.12 (Berkeley) 6/29/91
-.\"    $NetBSD: strftime.3,v 1.25 2010/04/29 10:03:12 jruoho Exp $
+.\"    $NetBSD: strftime.3,v 1.26 2010/05/29 20:32:18 dholland Exp $
 .\"
-.Dd April 29, 2010
+.Dd May 29, 2010
 .Dt STRFTIME 3
 .Os
 .Sh NAME
@@ -247,3 +247,6 @@
 For example, in many locales
 .Cm \&%p
 yields an empty string.
+This problem can be avoided by inserting an extra space at the
+beginning of the format string and then skipping over it or removing
+it from the result.