man(7) -> mdoc(7).

1 files changed, 135 insertions, 165 deletions

diff --git a/usr.bin/hesinfo/hesinfo.1 b/usr.bin/hesinfo/hesinfo.1
index b43910c..226ff49 100644
--- a/usr.bin/hesinfo/hesinfo.1
+++ b/usr.bin/hesinfo/hesinfo.1
@@ -16,211 +16,181 @@
 .\" 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 HesiodNameType
+.Sh DESCRIPTION
+.Nm
 takes two arguments, a name to be resolved and a string, known
-as a HesiodNameType.  It then prints the information returned by
+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 indent
+.It Fl l
 Selects long format.
-.TP
-.B -b
-Prints the fully-qualified string passed to the nameserver.
-
-.PP
-.SS VALID Hesiod_Names
+.It Fl b
+Prints the fully\-qualified string passed to the nameserver.
+.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 \<username>
-the 8-character-or-less string used to identify users or classes
+.Bl -tag -width indent
+.It Aq Ar 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
+.Cm passwd ,
+.Cm pobox ,
 and
-.BR filsys.
-
-
-.TP
-.B \<uid>
+.Cm filsys .
+.It Aq Ar uid
 the id number assigned to a user.
-
-.TP
-.B \<groupid>
+.It Aq Ar groupid
 the id number assigned to a group.
-
-.TP
-.B \<groupname>
+.It Aq Ar groupname
 a name identifying a unique group.
-
-.TP 
-.B \<file-system-name>
-the name of an athena file system.
-
-.TP
-.B \<rvd server>:<pack>
-the name of an rvd's server and pack  seperated by a colon.
-
-.TP
-.B \<nfs server>:<partition>
-the name of an nfs server and its partition seperated by a colon.
-
-.TP
-.B \<workstation-name>
-the machine name of an Athena workstation (e.g. E40-343-3).
-
-.TP 
-.B \<service-name>
+.It Aq Ar file\-system\-name
+the name of an Athena file system.
+.It Xo
+.Ao Ar "rvd\-server" Ac : Ns Aq Ar pack
+.Xc
+the name of an rvd's server and pack separated by a colon.
+.It Xo
+.Ao Ar "nfs\-server" Ac : Ns Aq Ar partition
+.Xc
+the name of an
+.Tn NFS
+server and its partition separated by a colon.
+.It Aq Ar workstation\-name
+the machine name of an Athena workstation (e.g. E40\-343\-3).
+.It Aq Ar service\-name
 name of an Athena service (e.g. Zephyr).
-
-.TP
-.B \<service-type>
-name of Unix service (valid entries are defined in /etc/services).
-
-.TP
-.B \<printer-name>
+.It Aq Ar service\-type
+name of
+.Ux
+service (valid entries are defined in
+.Pa /etc/services ) .
+.It Aq Ar printer\-name
 name of a printer.
-
-.TP
-.B \<printer-cluster-name>
+.It Aq Ar printer\-cluster\-name
 name of an Athena print cluster.
-
-.TP
-.B \<foo>
+.It Aq Ar foo
 some
-.B hesinfo
-calls (e.g. 
-.B prclusterlist
-) do not require a specific
-.I HesiodName
-argument.  However, you must include a dummy string (e.g. 'foo') for
-.B hesinfo
- to work properly.
-
-
-
-
-.PP
-.SS VALID Hesiod_Name_Types
+.Nm
+calls (e.g.\&
+.Cm prclusterlist )
+do not require a specific
+.Ar HesiodName
+argument.
+However, you must include a dummy string (e.g.\&
+.Ql 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 indent
+.It Cm passwd
 returns string suitable for inclusion in
-.I /etc/passwd,
+.Pa /etc/passwd ,
 searching with
-.B <username>.
-
-.TP
-.B \ pobox
+.Aq Ar username .
+.It Cm pobox
 returns information on the pobox assigned to the user specified by
-.I HesiodName,
+.Ar HesiodName ,
 searching with
-.B <username>.
-
-
-.TP
-.B \ uid   
+.Aq Ar username .
+.It Cm uid
 returns string suitable for inclusion in
-.I /etc/passwd,
+.Pa /etc/passwd ,
 searching with
-.B <uid>.
-
-.TP
-.B \ gid   
+.Aq Ar uid .
+.It Cm gid
 returns string suitable for inclusion in
-.I /etc/group,
+.Pa /etc/group ,
 searching with
-.B <groupid>.
-
-.TP
-.B \ group
+.Aq Ar groupid .
+.It Cm group
 returns string suitable for inclusion in
-.I /etc/group,
+.Pa /etc/group ,
 searching with
-.B <groupname>.
-
-.TP
-.B \ grplist
+.Aq Ar groupname .
+.It Cm grplist
 returns subgroups included in superset
 defined by 
-.B <groupname>.
-
-.TP
-.B \ filsys
+.Aq Ar groupname .
+.It Cm filsys
 returns file system type, export point, server, mount mode, and import point
 for the following valid
-.I HesiodNames
-(see above)
-.B - <file system name>, <username>, <rvd server>:<pack>, 
-.B and <nfs server>:<partition>
-
-.TP
-.B \ cluster
+.Ar HesiodNames
+(see above) -
+.Aq Ar "file\-system\-name" ,
+.Aq Ar username ,
+.Ao Ar "rvd\-server" Ac : Ns Aq Ar pack ,
+and
+.Ao Ar "nfs\-server" Ac : Ns Aq Ar partition .
+.It Cm cluster
 returns information about the local cluster the workstation, specified by
-.B <workstation name>.
-Included is information about the local file and print servers.  This
-information is accesses by 
-.B clusterinfo 
+.Aq Ar "workstation\-name" .
+Included is information about the local file and print servers.
+This information is accesses by 
+.Sy clusterinfo 
 at boot time.
-
-.TP
-.B \ sloc
+.It Cm sloc
 returns network name of service host for
-.B <service-name>.
-
-.TP
-.B \ service
+.Aq Ar service\-name .
+.It Cm service
 returns Internet protocol type and protocol service port for
-.B <service-type>.
-
-.TP
-.B \ pcap
-returns a valid entry for /etc/printcap for
-.B <printer-name>.
-
-.TP 
-.B \ prcluserlist
+.Aq Ar service\-type .
+.It Cm pcap
+returns a valid entry for
+.Pa /etc/printcap
+for
+.Aq Ar printer\-name .
+.It Cm prcluserlist
 returns a list of print clusters.
-
-.TP 
-.B \ prcluster
+.It Cm prcluster
 returns a list of printers in a cluster specified by
-.B <printer-cluster-name>.
-
-.SH FILES
-/etc/hesiod.conf
-.SH "SEE ALSO"
-`Hesiod - Project Athena Technical Plan -- Name Service', named(8), hesiod(3)
-.SH AUTHOR
-Steve Dyer, IBM/Project Athena
-.br
+.Aq Ar printer\-cluster\-name .
+.El
+.Sh FILES
+.Bl -tag -width /etc/hesiod.conf
+.It Pa /etc/hesiod.conf
+.El
+.Sh SEE ALSO
+.Xr hesiod 3 ,
+.Xr named 8
+.Rs
+.%T "Hesiod - Project Athena Technical Plan -- Name Service"
+.Re
+.Sh AUTHORS
+.An Steve Dyer ,
+IBM/Project Athena
+.Pp
 Copyright 1987, 1988, 1996 by the Massachusetts Institute of Technology.
-.br