[src/trunk]: src/lib/libc/rpc Mostly punctuation fixes; uppercase some .Sh ar...

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

details:   https://anonhg.NetBSD.org/src/rev/e6afcd34615c
branches:  trunk
changeset: 515110:e6afcd34615c
user:      wiz <wiz%NetBSD.org@localhost>
date:      Sun Sep 16 18:51:10 2001 +0000

description:
Mostly punctuation fixes; uppercase some .Sh arguments, and misc. fixes.

diffstat:

 lib/libc/rpc/rpc_clnt_auth.3   |  14 +++++-------
 lib/libc/rpc/rpc_clnt_calls.3  |  41 +++++++++++++++++++------------------
 lib/libc/rpc/rpc_clnt_create.3 |  46 ++++++++++++++++++++---------------------
 lib/libc/rpc/rpc_svc_calls.3   |  31 +++++++++++++--------------
 lib/libc/rpc/rpc_svc_create.3  |  12 ++++++----
 lib/libc/rpc/rpc_svc_err.3     |  22 ++++++++++----------
 lib/libc/rpc/rpc_svc_reg.3     |   4 +-
 lib/libc/rpc/rpc_xdr.3         |   4 +-
 lib/libc/rpc/rpcbind.3         |   4 +-
 9 files changed, 88 insertions(+), 90 deletions(-)

diffs (truncated from 500 to 300 lines):

diff -r d56d66c9d412 -r e6afcd34615c lib/libc/rpc/rpc_clnt_auth.3
--- a/lib/libc/rpc/rpc_clnt_auth.3      Sun Sep 16 18:50:29 2001 +0000
+++ b/lib/libc/rpc/rpc_clnt_auth.3      Sun Sep 16 18:51:10 2001 +0000
@@ -2,14 +2,14 @@
 .\" Copyright 1989 AT&T
 .\" @(#)rpc_clnt_auth 1.4 89/07/20 SMI;
 .\" Copyright (c) 1988 Sun Microsystems, Inc. - All Rights Reserved.
-.\"    $NetBSD: rpc_clnt_auth.3,v 1.2 2001/09/16 02:17:41 wiz Exp $
+.\"    $NetBSD: rpc_clnt_auth.3,v 1.3 2001/09/16 18:51:10 wiz Exp $
 .Dd May 7, 1993
 .Dt RPC_CLNT_AUTH 3
 .Os
 .Sh NAME
-.Nm auth_destroy,
-.Nm authnone_create,
-.Nm authsys_create,
+.Nm auth_destroy ,
+.Nm authnone_create ,
+.Nm authsys_create ,
 .Nm authsys_create_default
 .Nd library routines for client side remote procedure call authentication
 .Sh LIBRARY
@@ -25,7 +25,6 @@
 .Ft "AUTH *"
 .Fn authsys_create_default "void"
 .Sh DESCRIPTION
-.Pp
 These routines are part of the
 RPC library that allows C language programs to make procedure
 calls on other machines across the network,
@@ -51,8 +50,7 @@
 and the
 .Dv SYS
 style of authentication is discussed here.
-.Pp
-.Sh Routines
+.Sh ROUTINES
 .Bl -tag -width authsys_create_default()
 .It Fn auth_destroy
 A function macro that destroys the authentication
@@ -96,4 +94,4 @@
 .Sh SEE ALSO
 .Xr rpc 3 ,
 .Xr rpc_clnt_calls 3 ,
-.Xr rpc_clnt_create 3 ,
+.Xr rpc_clnt_create 3
diff -r d56d66c9d412 -r e6afcd34615c lib/libc/rpc/rpc_clnt_calls.3
--- a/lib/libc/rpc/rpc_clnt_calls.3     Sun Sep 16 18:50:29 2001 +0000
+++ b/lib/libc/rpc/rpc_clnt_calls.3     Sun Sep 16 18:51:10 2001 +0000
@@ -2,21 +2,21 @@
 .\" Copyright 1989 AT&T
 .\" @(#)rpc_clnt_calls 1.4 89/07/20 SMI;
 .\" Copyright (c) 1988 Sun Microsystems, Inc. - All Rights Reserved.
-.\"    $NetBSD: rpc_clnt_calls.3,v 1.2 2001/09/16 02:17:41 wiz Exp $
+.\"    $NetBSD: rpc_clnt_calls.3,v 1.3 2001/09/16 18:51:10 wiz Exp $
 .Dd May 7, 1993
 .Dt RPC_CLNT_CALLS 3
 .Os
 .Sh NAME
-.Nm rpc_clnt_calls,
-.Nm clnt_call,
-.Nm clnt_freeres,
-.Nm clnt_geterr,
-.Nm clnt_perrno,
-.Nm clnt_perror,
-.Nm clnt_sperrno,
-.Nm clnt_sperror,
-.Nm rpc_broadcast,
-.Nm rpc_broadcast_exp,
+.Nm rpc_clnt_calls ,
+.Nm clnt_call ,
+.Nm clnt_freeres ,
+.Nm clnt_geterr ,
+.Nm clnt_perrno ,
+.Nm clnt_perror ,
+.Nm clnt_sperrno ,
+.Nm clnt_sperror ,
+.Nm rpc_broadcast ,
+.Nm rpc_broadcast_exp ,
 .Nm rpc_call
 .Nd library routines for client side calls
 .Sh LIBRARY
@@ -67,14 +67,14 @@
 handle can be created by an RPC creation routine such as
 .Fn clnt_create
 (see
-.Xr rpc_clnt_create 3 ).
+.Xr rpc_clnt_create 3 ) .
 .Pp
 These routines are safe for use in multithreaded applications.
 .Dv CLIENT
 handles can be shared between threads, however in this implementation
 requests by different threads are serialized (that is, the first request will
 receive its results before the second request is sent).
-.Sh Routines
+.Sh ROUTINES
 See
 .Xr rpc 3
 for the definition of the
@@ -91,7 +91,7 @@
 client creation routine such as
 .Fn clnt_create
 (see
-.Xr rpc_clnt_create 3 ).
+.Xr rpc_clnt_create 3 ) .
 The parameter
 .Fn inproc
 is the XDR function used to encode the procedure's parameters, and
@@ -164,7 +164,7 @@
 does not want the message to be output with
 .Fn printf
 (see
-.Xr printf 3 ),
+.Xr printf 3 ) ,
 or if a message format different than that supported by
 .Fn clnt_perrno
 is to be used.
@@ -174,7 +174,7 @@
 and
 .Fn clnt_spcreaterror
 (see
-.Xr rpc_clnt_create 3 ),
+.Xr rpc_clnt_create 3 ) ,
 .Fn clnt_sperrno
 does not return pointer to static data so the
 result will not get overwritten on each call.
@@ -202,7 +202,8 @@
 .Fa nettype
 is
 .Dv NULL ,
-it defaults to ``netpath'' .
+it defaults to
+.Dq netpath .
 Each time it receives a response,
 this routine calls
 .Fn eachresult ,
@@ -235,7 +236,7 @@
 uses
 .Dv AUTH_SYS
 credentials by default (see
-.Xr rpc_clnt_auth 3 ).
+.Xr rpc_clnt_auth 3 ) .
 .Pp
 .It Fn rpc_broadcast_exp
 Like
@@ -274,8 +275,8 @@
 can be any of the values listed on
 .Xr rpc 3 .
 This routine returns
-.Dv RPC_SUCCESS if it succeeds,
-or an appropriate status is returned.
+.Dv RPC_SUCCESS
+if it succeeds, or an appropriate status is returned.
 Use the
 .Fn clnt_perrno
 routine to translate failure status into error messages.
diff -r d56d66c9d412 -r e6afcd34615c lib/libc/rpc/rpc_clnt_create.3
--- a/lib/libc/rpc/rpc_clnt_create.3    Sun Sep 16 18:50:29 2001 +0000
+++ b/lib/libc/rpc/rpc_clnt_create.3    Sun Sep 16 18:51:10 2001 +0000
@@ -2,23 +2,23 @@
 .\" Copyright 1989 AT&T
 .\" @(#)rpc_clnt_create 1.5 89/07/24 SMI;
 .\" Copyright (c) 1988 Sun Microsystems, Inc. - All Rights Reserved.
-.\"    $NetBSD: rpc_clnt_create.3,v 1.3 2001/09/16 02:17:41 wiz Exp $
+.\"    $NetBSD: rpc_clnt_create.3,v 1.4 2001/09/16 18:51:10 wiz Exp $
 .Dd May 7, 1993
 .Dt RPC_CLNT_CREATE 3
 .Os
 .Sh NAME
-.Nm rpc_clnt_create,
-.Nm clnt_control,
-.Nm clnt_create,
-.Nm clnt_create_vers,
-.Nm clnt_destroy,
-.Nm clnt_dg_create,
-.Nm clnt_pcreateerror,
-.Nm clnt_raw_create,
-.Nm clnt_spcreateerror,
-.Nm clnt_tli_create,
-.Nm clnt_tp_create,
-.Nm clnt_vc_create,
+.Nm rpc_clnt_create ,
+.Nm clnt_control ,
+.Nm clnt_create ,
+.Nm clnt_create_vers ,
+.Nm clnt_destroy ,
+.Nm clnt_dg_create ,
+.Nm clnt_pcreateerror ,
+.Nm clnt_raw_create ,
+.Nm clnt_spcreateerror ,
+.Nm clnt_tli_create ,
+.Nm clnt_tp_create ,
+.Nm clnt_vc_create ,
 .Nm rpc_createerr
 .Nd "library routines for dealing with creation and manipulation of CLIENT handles"
 .Sh LIBRARY
@@ -56,8 +56,7 @@
 request to the server.
 On receipt of the request, the server calls a dispatch routine
 to perform the requested service, and then sends a reply.
-.Pp
-.Sh Routines
+.Sh ROUTINES
 .Bl -tag -width YYYYYYY
 .It Fn clnt_control
 A function macro to change or retrieve various information
@@ -81,13 +80,12 @@
 the timeout argument passed by
 .Fn clnt_call
 is ignored in all subsequent calls.
-
+.Pp
 Note:
 If you set the timeout value to 0
 .Fn clnt_control
-immediately returns an error
-(
-.Dv RPC_TIMEDOUT ).
+immediately returns an error (
+.Dv RPC_TIMEDOUT ) .
 Set the timeout parameter to 0 for batching calls.
 .Bl -column CLSET_FD_NCLOSE "struct timeval *" "do not close fd on destroy"
 .It Dv CLGET_SVC_ADDR Ta "struct netbuf *" Ta "get servers address"
@@ -156,7 +154,7 @@
 This mismatch will be discovered by a
 .Fn clnt_call
 later (see
-.Xr rpc_clnt_calls 3 ).
+.Xr rpc_clnt_calls 3 ) .
 .Pp
 .It Fn clnt_create_vers
 Generic client creation routine which is similar to
@@ -207,7 +205,7 @@
 This mismatch will be discovered by a
 .Fn clnt_call
 later (see
-.Xr rpc_clnt_calls 3N ).
+.Xr rpc_clnt_calls 3 ) .
 However,
 .Fn clnt_create_vers
 does this for you and returns a valid handle
@@ -236,7 +234,7 @@
 to destroy the associated
 .Dv AUTH
 structure (see
-.Xr rpc_clnt_auth 3 ).
+.Xr rpc_clnt_auth 3 ) .
 .Pp
 .It Fn clnt_dg_create
 This routine creates an RPC client for the remote program
@@ -257,7 +255,7 @@
 (see
 .Fn clnt_call
 in
-.Xr rpc_clnt_calls 3 ).
+.Xr rpc_clnt_calls 3 ) .
 The retry time out and the total time out periods can
 be changed using
 .Fn clnt_control .
@@ -302,7 +300,7 @@
 (see
 .Fn svc_raw_create
 in
-.Xr rpc_svc_create 3 ).
+.Xr rpc_svc_create 3 ) .
 This allows simulation of RPC and measurement of
 RPC overheads, such as round trip times,
 without any kernel or networking interference.
diff -r d56d66c9d412 -r e6afcd34615c lib/libc/rpc/rpc_svc_calls.3
--- a/lib/libc/rpc/rpc_svc_calls.3      Sun Sep 16 18:50:29 2001 +0000
+++ b/lib/libc/rpc/rpc_svc_calls.3      Sun Sep 16 18:51:10 2001 +0000
@@ -2,22 +2,22 @@
 .\" Copyright 1989 AT&T
 .\" @(#)rpc_svc_calls 1.5 89/07/25 SMI;
 .\" Copyright (c) 1988 Sun Microsystems, Inc. - All Rights Reserved.
-.\"    $NetBSD: rpc_svc_calls.3,v 1.2 2001/06/05 13:24:41 wiz Exp $
+.\"    $NetBSD: rpc_svc_calls.3,v 1.3 2001/09/16 18:51:10 wiz Exp $
 .Dd May 3, 1993
 .Dt RPC_SVC_CALLS 3
 .Os
 .Sh NAME
-.Nm svc_dg_enablecache,
-.Nm svc_exit,
-.Nm svc_fdset,
-.Nm svc_freeargs,
-.Nm svc_getargs,
-.Nm svc_getreq_common,
-.Nm svc_getreq_poll,
-.Nm svc_getreqset,
-.Nm svc_getrpccaller,
-.Nm svc_pollset,
-.Nm svc_run,
+.Nm svc_dg_enablecache ,
+.Nm svc_exit ,
+.Nm svc_fdset ,
+.Nm svc_freeargs ,
+.Nm svc_getargs ,
+.Nm svc_getreq_common ,
+.Nm svc_getreq_poll ,
+.Nm svc_getreqset ,