[src/trunk]: src/share/man/man9 document change in {, v}snprintf() behavior.

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

details:   https://anonhg.NetBSD.org/src/rev/d2e3d22d2b9f
branches:  trunk
changeset: 782811:d2e3d22d2b9f
user:      christos <christos%NetBSD.org@localhost>
date:      Wed Nov 21 17:18:11 2012 +0000

description:
document change in {,v}snprintf() behavior.

diffstat:

 share/man/man9/kprintf.9 |  12 ++++++++----
 1 files changed, 8 insertions(+), 4 deletions(-)

diffs (34 lines):

diff -r 80b010a8779e -r d2e3d22d2b9f share/man/man9/kprintf.9
--- a/share/man/man9/kprintf.9  Wed Nov 21 11:03:13 2012 +0000
+++ b/share/man/man9/kprintf.9  Wed Nov 21 17:18:11 2012 +0000
@@ -1,4 +1,4 @@
-.\"     $NetBSD: kprintf.9,v 1.31 2011/07/17 20:54:35 joerg Exp $
+.\"     $NetBSD: kprintf.9,v 1.32 2012/11/21 17:18:11 christos Exp $
 .\"
 .\" Copyright (c) 1998, 2002, 2007, 2011 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -27,7 +27,7 @@
 .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 .\" POSSIBILITY OF SUCH DAMAGE.
 .\"
-.Dd January 21, 2011
+.Dd November 21, 2012
 .Dt KPRINTF 9
 .Os
 .Sh NAME
@@ -250,9 +250,13 @@
 .Fn snprintf
 and
 .Fn vsnprintf
-functions return the number of characters placed in the buffer
+functions return the number of characters that would have been placed
+in the buffer
 .Fa buf .
-This is different to the user-space functions of the same name.
+if there was enough space in the buffer, not including the trailing
+.Dv NUL
+character used to terminate output strings like the user-space functions
+of the same name.
 .Pp
 The
 .Fn tprintf_open