-This will be fixed some time inthe near future.
-.Dp Li I
-Indent from left margin default amount (usually
-about a three quarters of an inch or eight
-constant width characters).
-.Dp Li R
-This left aligns the block about two inches from
-the right side of the page. It too, alas, needs
-work.
-.Dp
-.Tp Li \&.De
-Ends a
-.Li \&.Ds
-request.
-.Tp Li \&.Df
-Display a filled (formatted) block. Identical to
-.Li \&.Ds ,
-except the block of text is formatted (the edges are
-not left ragged). Takes the same modifers as
-.Li Ds .
-.Tp
-.Ss Tagged paragraphs and Columns
-The commands
-.Li \&.Tp
-and
-.Li \&.Dp
-create tagged paragraph
-lists.
-Like the
-.Li \&.Cx
-request,
-both require a begin and end. When
-.Li \&.Tp
-or
-.Li \&.Dp
-are called with arguments, they collect and
-create the tag portion from
-the arguments.
-Anything after the tag is placed in
-the paragraph portion.
-The
-.Li \&.Dp
-macro is essentially the same as
-the \&.Tp
-macro, but with a few added features.
-These are discussed following the
-.Li \&.Tp
-example.
-.Li \&.Tp
-and
-.Li \&.Dp
-can call several macros,
-these are:
-.Pp
-.Dl \&.Ad, \&.Ar, \&.Cm, \&.Em, \&.Er, \&.Ev, \&.Fl, \&.Fn, \&.Ic,
-.Dl \&.Li, \&.Nm, \&.Sy, \&.Va and \&.Xr.
+.It Ar indent
+Indents by one default indent value or tab. The default
+indent value is also used for the
+.Ql \&.D1
+display so one can be garanteed of the two types of displays
+lining up. This indent is nornally set to 6n or about two
+thirds of an inch (six constant width characters).
+.It Ar indent-two
+Indents two times the default indent value.
+.It Ar right
+This
+.Em left
+aligns the block about two inches from
+the right side of the page. This macro also needs
+work and perhaps may never be right in
+.Xr troff .
+.El
+.El
+.It ".Ed"
+End-display.
+.El
+.Ss Tagged Lists and Columns
+There are several types of lists which may be initiated with the
+.Ql ".Bl"
+begin-list macro. Items within the list
+are specified with the
+.Ql ".It"
+item macro and
+each list must end with the
+.Ql ".El"
+macro. Lists may be nested within themselves and within displays.
+Columns may be used inside of lists, but lists are unproven
+inside of columns.
+.Pp
+In addition, several list attributes may be specified such as
+the width of a tag, the list offset, and compactness specified
+(blank lines between items allowed or disallowed).
+The following list types are accepted by
+.Ql ".Bl":
+.Pp
+.Bl -ohang -compact
+.It Fl bullet
+.It Fl item
+.It Fl enum
+These three are the simplest types of lists. Once the
+.Ql ".Bl"
+macro has been given, items in the list are merely
+indicated by a line consisting solely of the
+.Ql ".It"
+macro. For example, the source text for a simple enumerated list
+would look like:
+.Bd -literal -offset indent-two
+\&.Bl -enum -compact
+\&.It
+\&Item one goes here.
+\&.It
+\&And item two here.
+\&.It
+\&Lastly item three goes here.
+\&.El
+.Ed
+.Pp
+The results:
+.Pp
+.Bl -enum -offset indent-two -compact
+.It
+Item one goes here.
+.It
+And item two here.
+.It
+Lastly item three goes here.
+.El
+.Pp
+A simple bullet list construction:
+.Bd -literal -offset indent-two
+\&.Bl -bullet -compact
+\&.It
+\&Bullet one goes here.
+\&.It
+\&Bullet two here.
+\&.El
+.Ed
+.Pp
+Produces:
+.Bl -bullet -offset indent-two -compact
+.It
+Bullet one goes here.
+.It
+Bullet two here.
+.El
+.Pp
+.It Fl tag
+.It Fl diag
+.It Fl hang
+.It Fl ohang
+.It Fl inset
+These list-types collect arguments specified with the
+.Ql \&.It
+macro and create a label which may be
+.Em inset
+into the forth coming text,
+.Em hanged
+(exdented) from the forth coming text,
+.Em overhanged
+set above the forth coming paragraph or
+.Em tagged
+(exdented and offset). This
+list was constructed with the
+.Ql Fl ohang
+list-type. The
+.Ql \&.It
+macro may call any callable macros for the inset, hang
+and tag list-types, but will not call macros for the
+diag type.
+Here is an example of inset labels:
+.Bl -inset -offset indent
+.It Em Tag
+The tagged list (also called a tagged paragraph) is the
+most common type of list used in the Berkeley manuals.
+.It Em Diag
+Diag lists create section four diagnostic lists
+and are similar to inset lists except callable
+macros are ignored.
+.It Em Hang
+Hanged labels are a matter of taste.
+.It Em Ohang
+Over hanging labels are nice when space is constrained.
+.It Em Inset
+Inset labels are useful for controlling blocks of
+paragraphs and are valuable for converting
+.Nm \-mdoc
+manuals to other formats.
+.El
+.Pp
+Here is the source text which produced the above example:
+.Bd -literal -offset indent
+\&.Bl -inset -offset indent
+\&.It Em Tag
+\&The tagged list (also called a tagged paragraph) is the
+\&most common type of list used in the Berkeley manuals.
+\&.It Em Diag
+\&Diag lists create section four diagnostic lists
+\&and are similar to inset lists except callable
+\¯os are ignored.
+\&.It Em Hang
+\&Hanged labels are a matter of taste.
+\&.It Em Ohang
+\&Over hanging labels are nice when space is constrained.
+\&.It Em Inset
+\&Inset labels are useful for controlling blocks of
+\¶graphs and are valuable for converting
+\&.Nm \-mdoc
+\&manuals to other formats.
+\&.El
+.Ed
+.Pp
+Here is a hanged list with just one item:
+.Bl -hang -offset indent
+.It Em Hanged
+labels appear similar to tagged lists when the
+label is smaller than the label width.
+.It Em Longer hanged list labels
+blend in to the paragraph unlike
+tagged paragraph labels.
+.El
+.Pp
+And the unfomatted text which created it:
+.Bd -literal -offset indent
+\&.Bl -hang -offset indent
+\&.It Em Hanged
+\&labels appear similar to tagged lists when the
+\&label is smaller than the label width.
+\&.It Em Longer hanged list labels
+\&blend in to the paragraph unlike
+\&tagged paragraph labels.
+\&.El
+.Ed
+.Pp
+The tagged list which follows uses an optional width specifier to controll
+the width of the tag.
+.Pp
+.Bl -tag -width "PAGEIN 10" -compact -offset indent
+.It SL 10
+sleep time of the process (seconds blocked)
+.It PAGEIN 10
+number of disk i/o's resulting from references
+by the process to pages not loaded in core.
+.It UID 10
+numerical user-id of process owner
+.It PPID 10
+numerical id of parent of process process priority
+(non-positive when in non-interruptible wait)
+.El