[src/trunk]: src/lib/libc/time mdoc'ify

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

details:   https://anonhg.NetBSD.org/src/rev/f379654f7869
branches:  trunk
changeset: 515104:f379654f7869
user:      wiz <wiz%NetBSD.org@localhost>
date:      Sun Sep 16 18:02:44 2001 +0000

description:
mdoc'ify

diffstat:

 lib/libc/time/zic.8 |  417 +++++++++++++++++++++------------------------------
 1 files changed, 175 insertions(+), 242 deletions(-)

diffs (truncated from 593 to 300 lines):

diff -r 9da2c61131f2 -r f379654f7869 lib/libc/time/zic.8
--- a/lib/libc/time/zic.8       Sun Sep 16 17:41:28 2001 +0000
+++ b/lib/libc/time/zic.8       Sun Sep 16 18:02:44 2001 +0000
@@ -1,308 +1,256 @@
-.\"    $NetBSD: zic.8,v 1.9 1999/11/16 22:41:02 kleink Exp $
-.TH ZIC 8
-.SH NAME
-zic \- time zone compiler
-.SH SYNOPSIS
-.B zic
-[
-.B \-v
-] [
-.B \-d
-.I directory
-] [
-.B \-l
-.I localtime
-] [
-.B \-p
-.I posixrules
-] [
-.B \-L
-.I leapsecondfilename
-] [
-.B \-s
-] [
-.B \-y
-.I command
-] [
-.I filename
-\&... ]
-.SH DESCRIPTION
-.if t .ds lq ``
-.if t .ds rq ''
-.if n .ds lq \&"\"
-.if n .ds rq \&"\"
-.de q
-\\$3\*(lq\\$1\*(rq\\$2
-..
-.I Zic
+.\"    $NetBSD: zic.8,v 1.10 2001/09/16 18:02:44 wiz Exp $
+.\" @(#)zic.8  7.19
+.Dd September 16, 2001
+.Os
+.Dt ZIC 8
+.Sh NAME
+.Nm zic
+.Nd time zone compiler
+.Sh SYNOPSIS
+.Nm
+.Op Fl d Ar directory
+.Op Fl L Ar leapsecondfilename
+.Op Fl l Ar localtime
+.Op Fl p Ar posixrules
+.Op Fl s
+.Op Fl v
+.Op Fl y Ar command
+.Op Ar Filename ...
+.Sh DESCRIPTION
+.Nm
 reads text from the file(s) named on the command line
 and creates the time conversion information files specified in this input.
 If a
-.I filename
+.Ar filename
 is
-.BR \- ,
+.Ar \&- ,
 the standard input is read.
-.PP
+.Pp
 These options are available:
-.TP
-.BI "\-d " directory
+.Bl -tag -width XXX -compact
+.It Fl d Ar directory
 Create time conversion information files in the named directory rather than
 in the standard directory named below.
-.TP
-.BI "\-l " timezone
-Use the given time zone as local time.
-.I Zic
-will act as if the input contained a link line of the form
-.sp
-.ti +.5i
-Link   \fItimezone\fP          localtime
-.TP
-.BI "\-p " timezone
-Use the given time zone's rules when handling POSIX-format
-time zone environment variables.
-.I Zic
-will act as if the input contained a link line of the form
-.sp
-.ti +.5i
-Link   \fItimezone\fP          posixrules
-.TP
-.BI "\-L " leapsecondfilename
+.It Fl L Ar leapsecondfilename
 Read leap second information from the file with the given name.
 If this option is not used,
 no leap second information appears in output files.
-.TP
-.B \-v
-Complain if a year that appears in a data file is outside the range
-of years representable by
-.IR time (2)
-values.
-.TP
-.B \-s
+.It Fl l Ar timezone
+Use the given time zone as local time.
+.Nm
+will act as if the input contained a link line of the form
+.Dl Link       timezone        localtime
+.It Fl p Ar timezone
+Use the given time zone's rules when handling POSIX-format
+time zone environment variables.
+.Nm
+will act as if the input contained a link line of the form
+.Dl Link       timezone        posixrules
+.It Fl s
 Limit time values stored in output files to values that are the same
 whether they're taken to be signed or unsigned.
 You can use this option to generate SVVS-compatible files.
-.TP
-.BI "\-y " command
+.It Fl v
+Complain if a year that appears in a data file is outside the range
+of years representable by
+.Xr time 3
+values.
+.It Fl y Ar command
 Use the given
-.I command
+.Ar command
 rather than
-.B yearistype
+.Em yearistype
 when checking year types (see below).
-.PP
+.Pp
 Input lines are made up of fields.
 Fields are separated from one another by any number of white space characters.
 Leading and trailing white space on input lines is ignored.
 An unquoted sharp character (#) in the input introduces a comment which extends
 to the end of the line the sharp character appears on.
-White space characters and sharp characters may be enclosed in double quotes
-(") if they're to be used as part of a field.
+White space characters and sharp characters may be enclosed in double
+quotes
+.Pq \&"
+.\" XXX "
+if they're to be used as part of a field.
 Any line that is blank (after comment stripping) is ignored.
 Non-blank lines are expected to be of one of three types:
 rule lines, zone lines, and link lines.
-.PP
+.Pp
 A rule line has the form
-.nf
-.ti +.5i
-.ta \w'Rule\0\0'u +\w'NAME\0\0'u +\w'FROM\0\0'u +\w'1973\0\0'u +\w'TYPE\0\0'u +\w'Apr\0\0'u +\w'lastSun\0\0'u +\w'2:00\0\0'u +\w'SAVE\0\0'u
-.sp
-Rule   NAME    FROM    TO      TYPE    IN      ON      AT      SAVE    LETTER/S
-.sp
+.Dl Rule       NAME    FROM    TO      TYPE    IN      ON      AT      SAVE    LETTER/S
 For example:
-.ti +.5i
-.sp
-Rule   US      1967    1973    \-      Apr     lastSun 2:00    1:00    D
-.sp
-.fi
+.Dl Rule       US      1967    1973    \-      Apr     lastSun 2:00    1:00    D
 The fields that make up a rule line are:
-.TP "\w'LETTER/S'u"
-.B NAME
+.Bl -tag -width "LETTER/S" -compact
+.It NAME
 Gives the (arbitrary) name of the set of rules this rule is part of.
-.TP
-.B FROM
+.It FROM
 Gives the first year in which the rule applies.
 Any integer year can be supplied; the Gregorian calendar is assumed.
 The word
-.B minimum
+.Em minimum
 (or an abbreviation) means the minimum year representable as an integer.
 The word
-.B maximum
+.Em maximum
 (or an abbreviation) means the maximum year representable as an integer.
 Rules can describe times that are not representable as time values,
 with the unrepresentable times ignored; this allows rules to be portable
 among hosts with differing time value types.
-.TP
-.B TO
+.It TO
 Gives the final year in which the rule applies.
 In addition to
-.B minimum
+.Em minimum
 and
-.B maximum
+.Em maximum
 (as above),
 the word
-.B only
+.Em only
 (or an abbreviation)
 may be used to repeat the value of the
-.B FROM
+.Em FROM
 field.
-.TP
-.B TYPE
+.It TYPE
 Gives the type of year in which the rule applies.
 If
-.B TYPE
+.Em TYPE
 is
-.B \-
+.Em \&-
 then the rule applies in all years between
-.B FROM
+.Em FROM
 and
-.B TO
+.Em TO
 inclusive.
 If
-.B TYPE
+.Em TYPE
 is something else, then
-.I zic
+.Nm
 executes the command
-.ti +.5i
-\fByearistype\fP \fIyear\fP \fItype\fP
-.br
+.Pp
+.Ic yearistype Ar year type
+.Pp
 to check the type of a year:
 an exit status of zero is taken to mean that the year is of the given type;
 an exit status of one is taken to mean that the year is not of the given type.
-.TP
-.B IN
+.It IN
 Names the month in which the rule takes effect.
 Month names may be abbreviated.
-.TP
-.B ON
+.It ON
 Gives the day on which the rule takes effect.
 Recognized forms include:
-.nf
-.in +.5i
-.sp
-.ta \w'Sun<=25\0\0'u
-5      the fifth of the month
-lastSun        the last Sunday in the month
-lastMon        the last Monday in the month
-Sun>=8 first Sunday on or after the eighth
-Sun<=25        last Sunday on or before the 25th
-.fi
-.in -.5i
-.sp
+.Bl -tag -width lastSun -compact -offset indent
+.It 5
+the fifth of the month
+.It lastSun
+the last Sunday in the month
+.It lastMon
+the last Monday in the month
+.It Sun>=8
+first Sunday on or after the eighth
+.It Sun<=25
+last Sunday on or before the 25th
+.El
 Names of days of the week may be abbreviated or spelled out in full.
 Note that there must be no spaces within the
-.B ON
+.Em ON
 field.
-.TP
-.B AT
+.It AT
 Gives the time of day at which the rule takes effect.
 Recognized forms include:
-.nf
-.in +.5i
-.sp
-.ta \w'1:28:13\0\0'u
-2      time in hours
-2:00   time in hours and minutes
-15:00  24-hour format time (for times after noon)
-1:28:14        time in hours, minutes, and seconds