[src/trunk]: src/lib/libc/net Complete prototypes, markup NULL, complete retu...

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

details:   https://anonhg.NetBSD.org/src/rev/3d69a0d644a1
branches:  trunk
changeset: 767292:3d69a0d644a1
user:      jruoho <jruoho%NetBSD.org@localhost>
date:      Thu Jul 14 21:25:42 2011 +0000

description:
Complete prototypes, markup NULL, complete return values, more markup.

diffstat:

 lib/libc/net/getprotoent.3 |  23 +++++++++++++++++------
 1 files changed, 17 insertions(+), 6 deletions(-)

diffs (59 lines):

diff -r 51e234b8dc54 -r 3d69a0d644a1 lib/libc/net/getprotoent.3
--- a/lib/libc/net/getprotoent.3        Thu Jul 14 18:19:49 2011 +0000
+++ b/lib/libc/net/getprotoent.3        Thu Jul 14 21:25:42 2011 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: getprotoent.3,v 1.11 2003/08/07 16:43:09 agc Exp $
+.\"    $NetBSD: getprotoent.3,v 1.12 2011/07/14 21:25:42 jruoho Exp $
 .\"
 .\" Copyright (c) 1983, 1991, 1993
 .\"    The Regents of the University of California.  All rights reserved.
@@ -29,7 +29,7 @@
 .\"
 .\"     @(#)getprotoent.3      8.1 (Berkeley) 6/4/93
 .\"
-.Dd June 4, 1993
+.Dd July 15, 2011
 .Dt GETPROTOENT 3
 .Os
 .Sh NAME
@@ -49,8 +49,10 @@
 .Fn getprotobyname "const char *name"
 .Ft struct protoent *
 .Fn getprotobynumber "int proto"
+.Ft void
 .Fn setprotoent "int stayopen"
-.Fn endprotoent
+.Ft void
+.Fn endprotoent "void"
 .Sh DESCRIPTION
 The
 .Fn getprotoent ,
@@ -73,7 +75,7 @@
 .Ed
 .Pp
 The members of this structure are:
-.Bl -tag -width p_aliases
+.Bl -tag -width p_aliases -offset indent
 .It Fa p_name
 The official name of the protocol.
 .It Fa p_aliases
@@ -116,8 +118,17 @@
 .Dv EOF
 is encountered.
 .Sh RETURN VALUES
-Null pointer
-(0) returned on
+Upon success,
+.Fn getprotoent ,
+.Fn getprotobyname ,
+and
+.Fn getprotobynumber
+return a pointer to the
+.Vt protoent
+structure as described above.
+A
+.Dv NULL
+pointer is returned on
 .Dv EOF
 or error.
 .Sh FILES