[src/trunk]: src/usr.bin/hesinfo Convert to mdoc.

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

details:   https://anonhg.NetBSD.org/src/rev/50950f9d405e
branches:  trunk
changeset: 555235:50950f9d405e
user:      wiz <wiz%NetBSD.org@localhost>
date:      Wed Nov 12 12:33:13 2003 +0000

description:
Convert to mdoc.

diffstat:

 usr.bin/hesinfo/hesinfo.1 |  288 +++++++++++++++++++--------------------------
 1 files changed, 123 insertions(+), 165 deletions(-)

diffs (truncated from 345 to 300 lines):

diff -r fc28f045e7c8 -r 50950f9d405e usr.bin/hesinfo/hesinfo.1
--- a/usr.bin/hesinfo/hesinfo.1 Wed Nov 12 12:06:24 2003 +0000
+++ b/usr.bin/hesinfo/hesinfo.1 Wed Nov 12 12:33:13 2003 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: hesinfo.1,v 1.8 2003/06/27 08:50:50 wiz Exp $
+.\"    $NetBSD: hesinfo.1,v 1.9 2003/11/12 12:33:13 wiz Exp $
 .\"
 .\" from: #Id: hesinfo.1,v 1.9 1996/11/07 01:57:12 ghudson Exp #
 .\"
@@ -15,213 +15,171 @@
 .\" M.I.T. makes no representations about the suitability of
 .\" this software for any purpose.  It is provided "as is"
 .\" without express or implied warranty.
-.TH HESINFO 1 "27 October 1996"
-.FM mit
-.SH NAME
-hesinfo \- find out what is stored in the Hesiod database
-.SH SYNOPSIS
-.nf
-hesinfo \fI[-bl]\fR \fIHesiodName\fR \fIHesiodNameType\fR
-.SH DESCRIPTION
-.I hesinfo
+.Dd October 27, 1996
+.Dt HESINFO 1
+.Os
+.Sh NAME
+.Nm hesinfo
+.Nd find out what is stored in the Hesiod database
+.Sh SYNOPSIS
+.Nm
+.Op Fl bl
+.Ar HesiodName
+.Ar HesiodNameType
+.Sh DESCRIPTION
+.Nm
 takes two arguments, a name to be resolved and a string, known
-as a HesiodNameType.
+as a
+.Ar HesiodNameType .
 It then prints the information returned by
 the Hesiod nameserver.
-.PP
+.Pp
 The value returned by
-.B hesinfo
+.Nm
 is of the type
-.I HesiodNameType.
-.PP
-.I hesinfo
+.Ar HesiodNameType .
+.Pp
+.Nm
 understands the following options:
-.TP
-.B -l
+.Bl -tag -width XX -offset indent
+.It Fl l
 Selects long format.
-.TP
-.B -b
+.It Fl b
 Prints the fully-qualified string passed to the nameserver.
-
-.PP
-.SS VALID Hesiod_Names
+.El
+.Ss VALID Hesiod_Names
 The following types of identifiers may be used in the
-.I HesiodName
+.Ar HesiodName
 argument to
-.B hesinfo.
+.Nm .
 These values will be resolved by accessing the
-.B hesiod
+.Xr hesiod 3
 database.
-
-.TP
-.B \\*[Lt]username\*[Gt]
+.Bl -tag -width XnfsXserverX:XpartitionXX
+.It Aq username
 the 8-character-or-less string used to identify users or classes
 (e.g. joeuser, root, 1.00, etc).
 Used with the
-.I Hesiod_Name_Types
-.BR passwd,
-.BR pobox,
+.Ar Hesiod_Name_Types
+.Dv passwd ,
+.Dv pobox ,
 and
-.BR filsys.
-
-
-.TP
-.B \\*[Lt]uid\*[Gt]
+.Dv filsys .
+.It Aq uid
 the id number assigned to a user.
-
-.TP
-.B \\*[Lt]groupid\*[Gt]
+.It Aq groupid
 the id number assigned to a group.
-
-.TP
-.B \\*[Lt]groupname\*[Gt]
+.It Aq groupname
 a name identifying a unique group.
-
-.TP
-.B \\*[Lt]file-system-name\*[Gt]
+.It Aq file-system-name
 the name of an athena file system.
-
-.TP
-.B \\*[Lt]rvd server\*[Gt]:\*[Lt]pack\*[Gt]
-the name of an rvd's server and pack  separated by a colon.
-
-.TP
-.B \\*[Lt]nfs server\*[Gt]:\*[Lt]partition\*[Gt]
+.It Ao rvd server Ac Ns : Ns Aq pack
+the name of an rvd's server and pack separated by a colon.
+.It Ao nfs server Ac Ns : Ns Aq partition
 the name of an nfs server and its partition separated by a colon.
-
-.TP
-.B \\*[Lt]workstation-name\*[Gt]
+.It Aq workstation-name
 the machine name of an Athena workstation (e.g. E40-343-3).
-
-.TP
-.B \\*[Lt]service-name\*[Gt]
+.It Aq service-name
 name of an Athena service (e.g. Zephyr).
-
-.TP
-.B \\*[Lt]service-type\*[Gt]
-name of Unix service (valid entries are defined in /etc/services).
-
-.TP
-.B \\*[Lt]printer-name\*[Gt]
+.It Aq service-type
+name of Unix service (valid entries are defined in
+.Pa /etc/services ) .
+.It Aq printer-name
 name of a printer.
-
-.TP
-.B \\*[Lt]printer-cluster-name\*[Gt]
+.It Aq printer-cluster-name
 name of an Athena print cluster.
-
-.TP
-.B \\*[Lt]foo\*[Gt]
+.It Aq foo
 some
-.B hesinfo
-calls (e.g.
-.B prclusterlist
-) do not require a specific
-.I HesiodName
+.Nm
+calls (e.g.,
+.Dv prclusterlist )
+do not require a specific
+.Ar HesiodName
 argument.
-However, you must include a dummy string (e.g. 'foo') for
-.B hesinfo
- to work properly.
-
-
-
-
-.PP
-.SS VALID Hesiod_Name_Types
+However, you must include a dummy string (e.g.,
+.Dq foo )
+for
+.Nm
+to work properly.
+.El
+.Ss VALID Hesiod_Name_Types
 The following symbols are valid substitutions for the
-.I HesiodNameType
+.Ar HesiodNameType
 argument to
-.B hesinfo.
-
-.TP
-.B \ passwd
+.Nm .
+.Bl -tag -width passwdX
+.It passwd
 returns string suitable for inclusion in
-.I /etc/passwd,
+.Pa /etc/passwd ,
 searching with
-.B \*[Lt]username\*[Gt].
-
-.TP
-.B \ pobox
+.Aq username .
+.It pobox
 returns information on the pobox assigned to the user specified by
-.I HesiodName,
+.Ar HesiodName ,
 searching with
-.B \*[Lt]username\*[Gt].
-
-
-.TP
-.B \ uid
+.Aq username .
+.It uid
 returns string suitable for inclusion in
-.I /etc/passwd,
+.Pa /etc/passwd ,
 searching with
-.B \*[Lt]uid\*[Gt].
-
-.TP
-.B \ gid
+.Aq uid .
+.It gid
 returns string suitable for inclusion in
-.I /etc/group,
+.Pa /etc/group ,
 searching with
-.B \*[Lt]groupid\*[Gt].
-
-.TP
-.B \ group
+.Aq groupid .
+.It group
 returns string suitable for inclusion in
-.I /etc/group,
+.Pa /etc/group ,
 searching with
-.B \*[Lt]groupname\*[Gt].
-
-.TP
-.B \ grplist
-returns subgroups included in superset
-defined by
-.B \*[Lt]groupname\*[Gt].
-
-.TP
-.B \ filsys
-returns file system type, export point, server, mount mode, and import point
-for the following valid
-.I HesiodNames
-(see above)
-.B - \*[Lt]file system name\*[Gt], \*[Lt]username\*[Gt], \*[Lt]rvd server\*[Gt]:\*[Lt]pack\*[Gt],
-.B and \*[Lt]nfs server\*[Gt]:\*[Lt]partition\*[Gt]
-
-.TP
-.B \ cluster
+.Aq groupname .
+.It grplist
+returns subgroups included in superset defined by
+.Aq groupname .
+.It filsys
+returns file system type, export point, server, mount mode, and
+import point for the following valid
+.Ar HesiodNames
+(see above) -
+.Aq Dv file system name ,
+.Aq Dv username ,
+.Ao Dv rvd server Ac Ns : Ns Aq pack ,
+and
+.Ao Dv nfs server Ac Ns : Ns Aq partition .
+.It cluster
 returns information about the local cluster the workstation, specified by
-.B \*[Lt]workstation name\*[Gt].
-Included is information about the local file and print servers.  This
-information is accesses by
-.B clusterinfo
+.Aq workstation name .
+Included is information about the local file and print servers.
+This information is accesses by
+.Dv clusterinfo
 at boot time.
-
-.TP
-.B \ sloc
+.It sloc
 returns network name of service host for
-.B \*[Lt]service-name\*[Gt].
-
-.TP
-.B \ service
+.Aq service-name .
+.It service
 returns Internet protocol type and protocol service port for
-.B \*[Lt]service-type\*[Gt].
-