[src/trunk]: src/lib/libpthread Same here; fix LIBRARY, add COMPATIBILITY/ERR...

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

details:   https://anonhg.NetBSD.org/src/rev/245d79978da1
branches:  trunk
changeset: 756112:245d79978da1
user:      jruoho <jruoho%NetBSD.org@localhost>
date:      Tue Jul 06 22:24:56 2010 +0000

description:
Same here; fix LIBRARY, add COMPATIBILITY/ERRORS, etc.

diffstat:

 lib/libpthread/pthread_attr_getname_np.3 |  29 +++++++++++++---------
 lib/libpthread/pthread_attr_setname_np.3 |  39 ++++++++++++++++++++-----------
 2 files changed, 42 insertions(+), 26 deletions(-)

diffs (146 lines):

diff -r 9750dbf3c885 -r 245d79978da1 lib/libpthread/pthread_attr_getname_np.3
--- a/lib/libpthread/pthread_attr_getname_np.3  Tue Jul 06 21:58:18 2010 +0000
+++ b/lib/libpthread/pthread_attr_getname_np.3  Tue Jul 06 22:24:56 2010 +0000
@@ -1,4 +1,4 @@
-.\"     $NetBSD: pthread_attr_getname_np.3,v 1.1 2007/12/14 21:51:21 yamt Exp $
+.\"     $NetBSD: pthread_attr_getname_np.3,v 1.2 2010/07/06 22:24:56 jruoho Exp $
 .\"
 .\" Copyright (c)2007 YAMAMOTO Takashi,
 .\" All rights reserved.
@@ -25,7 +25,7 @@
 .\" SUCH DAMAGE.
 .\"
 .\" ------------------------------------------------------------
-.Dd December 15, 2007
+.Dd July 7, 2010
 .Dt PTHREAD_ATTR_GETNAME_NP 3
 .Os
 .Sh NAME
@@ -33,7 +33,7 @@
 .Nd set descriptive name of an attribute
 .\" ------------------------------------------------------------
 .Sh LIBRARY
-.Lb libc
+.Lb libpthread
 .\" ------------------------------------------------------------
 .Sh SYNOPSIS
 .In pthread.h
@@ -42,10 +42,11 @@
     "size_t len"
 .\" ------------------------------------------------------------
 .Sh DESCRIPTION
+The
 .Fn pthread_attr_getname_np
-gets the descriptive name of the attribute.
-It takes the following arguments.
-.Bl -tag -width target
+function gets the descriptive name of a thread attribute.
+It takes the following arguments:
+.Bl -tag -width target -offset indent
 .It Fa attr
 The attribute whose descriptive name will be obtained.
 .It Fa name
@@ -56,16 +57,20 @@
 in bytes.
 .El
 .\" ------------------------------------------------------------
-.Sh RETURN VALUES
+.Sh COMPATIBILITY
+The
 .Fn pthread_attr_getname_np
-returns 0 on success.
-Otherwise,
+function is a non-standard extension.
+.\" ------------------------------------------------------------
+.Sh RETURN VALUES
+The
 .Fn pthread_attr_getname_np
-returns an error number described in
-.Xr errno 2 .
+function returns 0 on success.
+Otherwise, an error number described in
+.Xr errno 2
+is returned.
 .\" ------------------------------------------------------------
 .\".Sh ERRORS
 .\" ------------------------------------------------------------
 .Sh SEE ALSO
-.Xr errno 2 ,
 .Xr pthread_attr_setname_np 3
diff -r 9750dbf3c885 -r 245d79978da1 lib/libpthread/pthread_attr_setname_np.3
--- a/lib/libpthread/pthread_attr_setname_np.3  Tue Jul 06 21:58:18 2010 +0000
+++ b/lib/libpthread/pthread_attr_setname_np.3  Tue Jul 06 22:24:56 2010 +0000
@@ -1,4 +1,4 @@
-.\"     $NetBSD: pthread_attr_setname_np.3,v 1.2 2008/05/26 08:41:42 wiz Exp $
+.\"     $NetBSD: pthread_attr_setname_np.3,v 1.3 2010/07/06 22:24:56 jruoho Exp $
 .\"
 .\" Copyright (c)2007 YAMAMOTO Takashi,
 .\" All rights reserved.
@@ -25,7 +25,7 @@
 .\" SUCH DAMAGE.
 .\"
 .\" ------------------------------------------------------------
-.Dd December 15, 2007
+.Dd July 7, 2010
 .Dt PTHREAD_ATTR_SETNAME_NP 3
 .Os
 .Sh NAME
@@ -33,7 +33,7 @@
 .Nd set descriptive name of an attribute
 .\" ------------------------------------------------------------
 .Sh LIBRARY
-.Lb libc
+.Lb libpthread
 .\" ------------------------------------------------------------
 .Sh SYNOPSIS
 .In pthread.h
@@ -42,10 +42,11 @@
     "void *arg"
 .\" ------------------------------------------------------------
 .Sh DESCRIPTION
+The
 .Fn pthread_attr_setname_np
-sets the descriptive name of the attribute.
-It takes the following arguments.
-.Bl -tag -width attr
+function sets the descriptive name of a thread attribute.
+It takes the following arguments:
+.Bl -tag -width attr -offset indent
 .It Fa attr
 The attribute whose descriptive name will be set.
 .It Fa name
@@ -61,16 +62,26 @@
 .Fa name .
 .El
 .\" ------------------------------------------------------------
-.Sh RETURN VALUES
+.Sh COMPATIBILITY
+The
 .Fn pthread_attr_setname_np
-returns 0 on success.
-Otherwise,
+function is a non-standard extension.
+.\" ------------------------------------------------------------
+.Sh RETURN VALUES
+The
 .Fn pthread_attr_setname_np
-returns an error number described in
-.Xr errno 2 .
+function returns 0 on success.
+Otherwise an error number is returned to indicate the error.
 .\" ------------------------------------------------------------
-.\".Sh ERRORS
-.\" ------------------------------------------------------------
+.Sh ERRORS
+The
+.Fn pthread_attr_setname_np
+function will fail if:
+.Bl -tag -width Er
+.It Bq Er EINVAL
+Invalid parameter.
+.It Bq Er ENOMEM
+Insufficient memory.
+.El
 .Sh SEE ALSO
-.Xr errno 2 ,
 .Xr pthread_attr_getname_np 3