summaryrefslogtreecommitdiffstats
path: root/contrib/groff
diff options
context:
space:
mode:
authorru <ru@FreeBSD.org>2001-07-13 09:06:00 +0000
committerru <ru@FreeBSD.org>2001-07-13 09:06:00 +0000
commit7d7d18d267f6bb01b910afd10cefaee1a9e205d9 (patch)
tree5a2a9616223b10e01209377334052d0e8d50813c /contrib/groff
parentf476c49e72e784b36a95795e8ed18676527c61a1 (diff)
downloadFreeBSD-src-7d7d18d267f6bb01b910afd10cefaee1a9e205d9.zip
FreeBSD-src-7d7d18d267f6bb01b910afd10cefaee1a9e205d9.tar.gz
Import latest mdoc(7) fixes of mine.
Fold -xwidth functionality into -width. .Bl now tests whether string immediately following a leading dot starts with a valid macro name. Added similar functionality to the -column list's column width specifiers. For example, the following now works as expected: .Bl -column ".Va hw.crusoe.percentage" ".Vt integer" "Changeable" .It Sy "Name\tType\tChangeable\tDescription" .It Va hw.crusoe.longrun Ta Vt integer Ta yes Ta "LongRun mode:" .It Ta Ta Ta "0: minimum frequency mode" .It Ta Ta Ta "1: power-saving mode" .It Ta Ta Ta "2: performance mode" .It Ta Ta Ta "3: maximum frequency mode" .It Va hw.crusoe.frequency Ta Vt integer Ta no Ta "Current frequency (MHz)." .It Va hw.crusoe.voltage Ta Vt integer Ta no Ta "Current voltage (mV)." .It Va hw.crusoe.percentage Ta Vt integer Ta no Ta "Processing performance (%)." .El This is especially useful for groff devices with variable width fonts, like -Tps or -TX100.
Diffstat (limited to 'contrib/groff')
-rw-r--r--contrib/groff/tmac/doc.tmac151
-rw-r--r--contrib/groff/tmac/groff_mdoc.man144
2 files changed, 169 insertions, 126 deletions
diff --git a/contrib/groff/tmac/doc.tmac b/contrib/groff/tmac/doc.tmac
index 3869864..5b8ec41 100644
--- a/contrib/groff/tmac/doc.tmac
+++ b/contrib/groff/tmac/doc.tmac
@@ -2980,6 +2980,9 @@
. nr doc-reg-Bl 1
. while (\n[doc-reg-Bl] <= \n[.$]) \{\
. ds doc-arg\n[doc-reg-Bl] "\$[\n[doc-reg-Bl]]
+. \" dummy type and space so that doc-save-global-vars() doesn't warn
+. nr doc-type\n[doc-reg-Bl] 0
+. ds doc-space\n[doc-reg-Bl]
. nr doc-reg-Bl +1
. \}
.
@@ -3011,7 +3014,7 @@
.
.de doc-Bl-usage
. tm1 "Usage: .Bl {-hang | -ohang | -tag | -diag | -inset}
-. tm1 " [-width <string>] [-xwidth <command>]
+. tm1 " [-width <string>]
. tm1 " [-offset <string>] [-compact]
. tm1 " .Bl -column [-offset <string>] <string1> <string2> ...
. tm1 " .Bl {-item | -enum [-nested] | -bullet | -hyphen | -dash}
@@ -3074,56 +3077,25 @@
. el \{ .ie "\*[doc-arg\n[doc-arg-ptr]]"-width" \{\
. nr doc-arg-ptr +1
. ds doc-tag-width-stack\n[doc-list-depth] TagwidtH
-. ds doc-str-dBla "\*[doc-arg\n[doc-arg-ptr]]
.
-. \" test whether argument is a valid numeric expression
-. nr doc-reg-dBla1 0
-. if \B(\*[doc-str-dBla]) \{\
-. \" disable warnings related to scaling indicators (32)
-. nr doc-reg-dBla2 \n[.warn]
-. warn (\n[.warn] - (\n[.warn] / 32 % 2 * 32))
-.
-. \" values without a scaling indicator are taken as strings;
-. \" we test whether the parameter string with and without the last
-. \" character yields identical numerical results (ignoring the
-. \" scaling indicator)
-. ds doc-str-dBla1 "\*[doc-str-dBla]
-. substring doc-str-dBla1 1 -1
-. if \B(\*[doc-str-dBla1]) \{\
-. nr doc-reg-dBla3 (;(\*[doc-str-dBla]))
-. nr doc-reg-dBla4 (\*[doc-str-dBla1])
-. if (\n[doc-reg-dBla3] == \n[doc-reg-dBla4]) \
-. nr doc-reg-dBla1 1
-. \}
-.
-. \" enable all warnings again
-. warn \n[doc-reg-dBla2]
-. \}
-.
-. ie \n[doc-reg-dBla1] \
-. nr doc-list-indent-stack\n[doc-list-depth] (\*[doc-str-dBla])
-. el \{\
-. doc-get-arg-width \n[doc-arg-ptr]
-. ie (\n[doc-width] == 2) \{\
-. \" if the width parameter is a macro, use the macro's
-. \" width as specified in doc-common
-. doc-get-arg-type \*[doc-str-dBla]
-. ie (\n[doc-arg-type] == 1) \
-. nr doc-list-indent-stack\n[doc-list-depth] \n[\*[doc-str-dBla]]
-. el \
-. nr doc-list-indent-stack\n[doc-list-depth] (\n[doc-width]u * \n[doc-fixed-width]u)
-. \}
+. ds doc-str-dBla "\*[doc-arg\n[doc-arg-ptr]]
+. substring doc-str-dBla 1 2
+. ie .\*[doc-str-dBla] \{\
+. ds doc-str-dBla "\*[doc-arg\n[doc-arg-ptr]]
+. substring doc-str-dBla 2
+. doc-first-parameter \*[doc-str-dBla]
+. doc-get-width "\*[doc-str-dfp]
+. doc-get-arg-type "\*[doc-str-dfp]
+. ie (\n[doc-arg-type] == 1) \
+. nr doc-reg-dBla1 1
. el \
-. nr doc-list-indent-stack\n[doc-list-depth] (\n[doc-width]u * \n[doc-fixed-width]u)
-. \}\}
-.
-. el \{ .ie "\*[doc-arg\n[doc-arg-ptr]]"-xwidth" \{\
-. nr doc-arg-ptr +1
-. ds doc-tag-width-stack\n[doc-list-depth] TagwidtH
+. nr doc-reg-dBla1 0
+. \}
+. el \
+. nr doc-reg-dBla1 0
+. ds doc-str-dBla "\*[doc-arg\n[doc-arg-ptr]]
.
-. ds doc-str-dBla \*[doc-arg\n[doc-arg-ptr]]
-. substring doc-str-dBla 1 2
-. if .\*[doc-str-dBla] \{\
+. ie \n[doc-reg-dBla1] \{\
. \" execute string in a box to get the width of the diversion
. ds doc-str-dBla \*[doc-arg\n[doc-arg-ptr]]
. doc-save-global-vars
@@ -3139,9 +3111,49 @@
. box
. doc-restore-global-vars
. doc-get-width \h'\n[dl]u'
+. nr doc-list-indent-stack\n[doc-list-depth] (\n[doc-width]u * \n[doc-fixed-width]u)
. \}
-. nr doc-list-indent-stack\n[doc-list-depth] (\n[doc-width]u * \n[doc-fixed-width]u)
-. \}
+. el \{\
+. \" test whether argument is a valid numeric expression
+. nr doc-reg-dBla1 0
+. if \B(\*[doc-str-dBla]) \{\
+. \" disable warnings related to scaling indicators (32)
+. nr doc-reg-dBla2 \n[.warn]
+. warn (\n[.warn] - (\n[.warn] / 32 % 2 * 32))
+.
+. \" values without a scaling indicator are taken as strings;
+. \" we test whether the parameter string with and without the last
+. \" character yields identical numerical results (ignoring the
+. \" scaling indicator)
+. ds doc-str-dBla1 "\*[doc-str-dBla]
+. substring doc-str-dBla1 1 -1
+. if \B(\*[doc-str-dBla1]) \{\
+. nr doc-reg-dBla3 (;(\*[doc-str-dBla]))
+. nr doc-reg-dBla4 (\*[doc-str-dBla1])
+. if (\n[doc-reg-dBla3] == \n[doc-reg-dBla4]) \
+. nr doc-reg-dBla1 1
+. \}
+.
+. \" enable all warnings again
+. warn \n[doc-reg-dBla2]
+. \}
+.
+. ie \n[doc-reg-dBla1] \
+. nr doc-list-indent-stack\n[doc-list-depth] (\*[doc-str-dBla])
+. el \{\
+. doc-get-arg-width \n[doc-arg-ptr]
+. ie (\n[doc-width] == 2) \{\
+. \" if the width parameter is a macro, use the macro's
+. \" width as specified in doc-common
+. doc-get-arg-type \*[doc-str-dBla]
+. ie (\n[doc-arg-type] == 1) \
+. nr doc-list-indent-stack\n[doc-list-depth] \n[\*[doc-str-dBla]]
+. el \
+. nr doc-list-indent-stack\n[doc-list-depth] (\n[doc-width]u * \n[doc-fixed-width]u)
+. \}
+. el \
+. nr doc-list-indent-stack\n[doc-list-depth] (\n[doc-width]u * \n[doc-fixed-width]u)
+. \}\}\}
.
. el \{ .ie "\*[doc-arg\n[doc-arg-ptr]]"-offset" \{\
. nr doc-arg-ptr +1
@@ -3185,14 +3197,49 @@
. \}\}\}
. el \
. nr doc-reg-dBla 0
-. \}\}\}\}
+. \}\}\}
.
. \" not a known keyword, so it specifies the width of the next column
. \" (if it is a column list)
. if !\n[doc-reg-dBla] \{\
. ie "\*[doc-list-type-stack\n[doc-list-depth]]"column-list" \{\
. nr doc-num-columns +1
-. ds doc-arg\n[doc-num-columns] "\*[doc-arg\n[doc-arg-ptr]]
+. ds doc-str-dBla \*[doc-arg\n[doc-arg-ptr]]
+. substring doc-str-dBla 1 2
+. ie .\*[doc-str-dBla] \{\
+. ds doc-str-dBla "\*[doc-arg\n[doc-arg-ptr]]
+. substring doc-str-dBla 2
+. doc-first-parameter \*[doc-str-dBla]
+. doc-get-width "\*[doc-str-dfp]
+. doc-get-arg-type "\*[doc-str-dfp]
+. ie (\n[doc-arg-type] == 1) \
+. nr doc-reg-dBla1 1
+. el \
+. nr doc-reg-dBla1 0
+. \}
+. el \
+. nr doc-reg-dBla1 0
+. ds doc-str-dBla "\*[doc-arg\n[doc-arg-ptr]]
+.
+. ie \n[doc-reg-dBla1] \{\
+. \" execute string in a box to get the width of the diversion
+. ds doc-str-dBla \*[doc-arg\n[doc-arg-ptr]]
+. doc-save-global-vars
+. doc-reset-args
+. box doc-box-dBla
+. ev doc-env-dBla
+. evc 0
+. in 0
+. nf
+. nop \*[doc-str-dBla]
+. br
+. ev
+. box
+. doc-restore-global-vars
+. ds doc-arg\n[doc-num-columns] "\h'\n[dl]u'
+. \}
+. el \
+. ds doc-arg\n[doc-num-columns] "\*[doc-arg\n[doc-arg-ptr]]
. \}
. el \{\
. tmc mdoc warning: Unknown keyword `\*[doc-arg\n[doc-arg-ptr]]'
diff --git a/contrib/groff/tmac/groff_mdoc.man b/contrib/groff/tmac/groff_mdoc.man
index c2eec8b..f228c53 100644
--- a/contrib/groff/tmac/groff_mdoc.man
+++ b/contrib/groff/tmac/groff_mdoc.man
@@ -322,7 +322,7 @@ and
.Ql \&Ar ,
to specify an optional flag with an argument:
.
-.Bl -tag -xwidth ".Op Fl s Ar bytes" -offset indent
+.Bl -tag -width ".Op Fl s Ar bytes" -offset indent
.It Op Fl s Ar bytes
is produced by
.Ql ".Op Fl s Ar bytes"
@@ -333,7 +333,7 @@ To prevent a string from being interpreted as a macro name, precede the
string with the escape sequence
.Ql \e& :
.
-.Bl -tag -xwidth ".Op \&Fl s \&Ar bytes" -offset indent
+.Bl -tag -width ".Op \&Fl s \&Ar bytes" -offset indent
.It Op \&Fl s \&Ar bytes
is produced by
.Ql ".Op \e&Fl s \e&Ar bytes"
@@ -403,7 +403,7 @@ The second method is to enclose the string with double quotes.
.Pp
For example:
.
-.Bl -tag -xwidth ".Fn fetch char\ *str" -offset indent
+.Bl -tag -width ".Fn fetch char\ *str" -offset indent
.It Fn fetch char\ *str
is created by
.Ql ".Fn fetch char\e *str"
@@ -759,7 +759,7 @@ In the following examples, the left (which is identical to the right) and
the middle part of the manual page header strings are shown.
.
.Bd -ragged
-.Bl -tag -xwidth ".Li .Dt\ FOO\ 2\ mac68k" -compact -offset indent
+.Bl -tag -width ".Li .Dt\ FOO\ 2\ mac68k" -compact -offset indent
.It Li ".Dt FOO 7"
.Ql FOO(7)
.Ql System Reference Manual
@@ -819,7 +819,7 @@ is the acronym for the operating system and
the release ID.
.
.Bd -ragged -compact
-.Bl -tag -xwidth ".No FreeBSD" -offset indent
+.Bl -tag -width ".No FreeBSD" -offset indent
.It ATT
7th, 7, III, 3, V, V.2, V.3, V.4
.It BSD
@@ -972,7 +972,7 @@ or
Some command line argument lists are quite long:
.
.Bd -ragged
-.Bl -tag -xwidth ".Nm make" -offset indent -compact
+.Bl -tag -width ".Nm make" -offset indent -compact
.It Nm make
.Op Fl eiknqrstv
.Op Fl D Ar variable
@@ -1099,7 +1099,7 @@ The address macro identifies an address construct.
.Pp
.Dl Usage: .Ad Ao address Ac ...
.Pp
-.Bl -tag -xwidth ".Li .Ad\ f1\ ,\ f2\ ,\ f3\ :" -compact -offset 15n
+.Bl -tag -width ".Li .Ad\ f1\ ,\ f2\ ,\ f3\ :" -compact -offset 15n
.It Li ".Ad addr1"
.Ad addr1
.It Li ".Ad addr1 ."
@@ -1124,7 +1124,7 @@ documented, or the name of the author of the actual manual page.
.Pp
.Dl Usage: .An Ao author name Ac ...
.Pp
-.Bl -tag -xwidth ".Li .An\ \*[q]Joe\ Author\*[q]\ )\ )\ ," -offset 15n
+.Bl -tag -width ".Li .An\ \*[q]Joe\ Author\*[q]\ )\ )\ ," -offset 15n
.It Li ".An \*[q]Joe Author\*[q]"
.An "Joe Author"
.It Li ".An \*[q]Joe Author\*[q] ,"
@@ -1169,7 +1169,7 @@ string is output.
.Pp
.Dl Usage: .Ar Oo Ao argument Ac Oc ...
.Pp
-.Bl -tag -xwidth ".Li .Ar\ file1\ file2" -compact -offset 15n
+.Bl -tag -width ".Li .Ar\ file1\ file2" -compact -offset 15n
.It Li .Ar
.Ar
.It Li ".Ar file1"
@@ -1197,7 +1197,7 @@ declaration for a device interface in a section four manual.
.Pp
.Dl Usage: .Cd Ao argument Ac ...
.Pp
-.Bl -tag -xwidth ".Li .Cd\ Xdevice\ le0\ at\ scode?X" -offset 15n
+.Bl -tag -width ".Li .Cd\ Xdevice\ le0\ at\ scode?X" -offset 15n
.It Li ".Cd \*[q]device le0 at scode?\*[q]"
.Cd "device le0 at scode?"
.El
@@ -1235,7 +1235,7 @@ is specified by the macro
.Pp
.Dl Usage: .Dv Ao defined variable Ac ...
.Pp
-.Bl -tag -xwidth ".Li .Dv\ MAXHOSTNAMELEN" -compact -offset 15n
+.Bl -tag -width ".Li .Dv\ MAXHOSTNAMELEN" -compact -offset 15n
.It Li ".Dv MAXHOSTNAMELEN"
.Dv MAXHOSTNAMELEN
.It Li ".Dv TIOCGPGRP )"
@@ -1259,7 +1259,7 @@ general text domain macro, as it would be used in a section two manual page.
.Pp
.Dl Usage: .Er Ao errno type Ac ...
.Pp
-.Bl -tag -xwidth ".Li .Bq\ Er\ ENOTDIR" -compact -offset 15n
+.Bl -tag -width ".Li .Bq\ Er\ ENOTDIR" -compact -offset 15n
.It Li ".Er ENOENT"
.Er ENOENT
.It Li ".Er ENOENT ) ;"
@@ -1279,7 +1279,7 @@ macro specifies an environment variable.
.Pp
.Dl Usage: .Ev Ao argument Ac ...
.Pp
-.Bl -tag -xwidth ".Li .Ev\ PRINTER\ )\ )\ ," -compact -offset 15n
+.Bl -tag -width ".Li .Ev\ PRINTER\ )\ )\ ," -compact -offset 15n
.It Li ".Ev DISPLAY"
.Ev DISPLAY
.It Li ".Ev PATH ."
@@ -1306,7 +1306,7 @@ macro is identical, but without the dash.
.Pp
.Dl Usage: .Fl Ao argument Ac ...
.Pp
-.Bl -tag -xwidth ".Li .Fl\ xyz\ )\ ," -compact -offset 15n
+.Bl -tag -width ".Li .Fl\ xyz\ )\ ," -compact -offset 15n
.It Li .Fl
.Fl
.It Li ".Fl cfv"
@@ -1345,7 +1345,7 @@ It is neither callable nor parsed.
.Pp
.Dl Usage: .Fd Ao argument Ac ...
.Pp
-.Bl -tag -xwidth ".Li .Fd\ X#include\ <sys/types.h>X" -compact -offset 15n
+.Bl -tag -width ".Li .Fd\ X#include\ <sys/types.h>X" -compact -offset 15n
.It Li ".Fd \*[q]#include <sys/types.h>\*[q]"
.Fd "#include <sys/types.h>"
.El
@@ -1370,7 +1370,7 @@ It also causes a line break, and is neither callable nor parsed.
.Pp
.Dl Usage: .In Ao header file Ac
.Pp
-.Bl -tag -xwidth ".Li .In\ stdio.h" -compact -offset 15n
+.Bl -tag -width ".Li .In\ stdio.h" -compact -offset 15n
.It Li ".In stdio.h"
.In stdio.h
.El
@@ -1388,7 +1388,7 @@ name to appear on the next line).
.Pp
.Dl Usage: .Ft Ao type Ac ...
.Pp
-.Bl -tag -xwidth ".Li .Ft\ struct\ stat" -compact -offset 15n
+.Bl -tag -width ".Li .Ft\ struct\ stat" -compact -offset 15n
.It Li ".Ft struct stat"
.Ft struct stat
.El
@@ -1403,7 +1403,7 @@ conventions.
.Pp
.Dl Usage: .Fn Ao function Ac Oo Ao parameter Ac Oc ...
.Pp
-.Bl -tag -xwidth ".Li .Fn\ align\ Xchar\ *ptrX\ ," -compact -offset 15n
+.Bl -tag -width ".Li .Fn\ align\ Xchar\ *ptrX\ ," -compact -offset 15n
.It Li ".Fn getchar"
.Fn getchar
.It Li ".Fn strlen ) ,"
@@ -1497,7 +1497,7 @@ may also be used to refer to structure members.
.Pp
.Dl Usage: .Fa Ao function argument Ac ...
.Pp
-.Bl -tag -xwidth ".Li .Fa\ d_namlen\ )\ )\ ," -compact -offset 15n
+.Bl -tag -width ".Li .Fa\ d_namlen\ )\ )\ ," -compact -offset 15n
.It Li ".Fa d_namlen ) ) ,"
.Fa d_namlen ) ) ,
.It Li ".Fa iov_len"
@@ -1545,7 +1545,7 @@ macro designates an interactive or internal command.
.Pp
.Dl Usage: .Ic Ao argument Ac ...
.Pp
-.Bl -tag -xwidth ".Li .Ic\ setenv\ ,\ unsetenv" -compact -offset 15n
+.Bl -tag -width ".Li .Ic\ setenv\ ,\ unsetenv" -compact -offset 15n
.It Li ".Ic :wq"
.Ic :wq
.It Li ".Ic \*[q]do while {...}\*[q]"
@@ -1571,7 +1571,7 @@ Available arguments to
and their results are:
.
.Pp
-.Bl -tag -xwidth ".Li libossaudio" -compact -offset indent
+.Bl -tag -width ".Li libossaudio" -compact -offset indent
.It Li libarm32
.Lb libarm32
.It Li libc
@@ -1627,7 +1627,7 @@ literal macro may be used for special characters, variable constants, etc.\&
.Pp
.Dl Usage: .Li Ao argument Ac ...
.Pp
-.Bl -tag -xwidth ".Li .Li\ cntrl-D\ )\ ," -compact -offset 15n
+.Bl -tag -width ".Li .Li\ cntrl-D\ )\ ," -compact -offset 15n
.It Li ".Li \een"
.Li \en
.It Li ".Li M1 M2 M3 ;"
@@ -1677,7 +1677,7 @@ it can not recall the first argument it was invoked with.
.Pp
.Dl Usage: .Nm Oo Ao argument Ac Oc ...
.Pp
-.Bl -tag -xwidth ".Li .Nm\ groff_mdoc" -compact -offset 15n
+.Bl -tag -width ".Li .Nm\ groff_mdoc" -compact -offset 15n
.It Li ".Nm groff_mdoc"
.Nm groff_mdoc
.It Li ".Nm \e-mdoc"
@@ -1707,7 +1707,7 @@ parenthesis.
.Pp
.Dl Usage: .Op Oo Ao option Ac Oc ...
.Pp
-.Bl -tag -xwidth ".Li .Op\ Fl\ c\ Ar\ objfil\ Op\ Ar\ corfil\ ," -compact -offset 15n
+.Bl -tag -width ".Li .Op\ Fl\ c\ Ar\ objfil\ Op\ Ar\ corfil\ ," -compact -offset 15n
.It Li .Op
.Op
.It Li ".Op Fl k"
@@ -1771,7 +1771,7 @@ string is output, which represents the current user's home directory.
.Pp
.Dl Usage: .Pa Oo Ao pathname Ac Oc ...
.Pp
-.Bl -tag -xwidth ".Li .Pa\ /tmp/fooXXXXX\ )\ ." -compact -offset 15n
+.Bl -tag -width ".Li .Pa\ /tmp/fooXXXXX\ )\ ." -compact -offset 15n
.It Li .Pa
.Pa
.It Li ".Pa /usr/share"
@@ -1798,7 +1798,7 @@ are:
.Pp
.Tn ANSI/ISO C
.Pp
-.Bl -tag -xwidth ".Li -iso9945-1-90" -compact -offset indent
+.Bl -tag -width ".Li -iso9945-1-90" -compact -offset indent
.It Li -ansiC
.St -ansiC
.It Li -ansiC-89
@@ -1813,7 +1813,7 @@ are:
.Tn POSIX
Part 1: System API
.Pp
-.Bl -tag -xwidth ".Li -p1003.1g-2000" -compact -offset indent
+.Bl -tag -width ".Li -p1003.1g-2000" -compact -offset indent
.It Li -iso9945-1-90
.St -iso9945-1-90
.It Li -iso9945-1-96
@@ -1840,7 +1840,7 @@ Part 1: System API
.Tn POSIX
Part 2: Shell and Utilities
.Pp
-.Bl -tag -xwidth ".Li -p1003.1g-2000" -compact -offset indent
+.Bl -tag -width ".Li -p1003.1g-2000" -compact -offset indent
.It Li -iso9945-2-93
.St -iso9945-2-93
.It Li -p1003.2
@@ -1853,7 +1853,7 @@ Part 2: Shell and Utilities
.Pp
.
X/Open
-.Bl -tag -xwidth ".Li -p1003.1g-2000" -compact -offset indent
+.Bl -tag -width ".Li -p1003.1g-2000" -compact -offset indent
.Pp
.It Li -susv2
.St -susv2
@@ -1882,7 +1882,7 @@ X/Open
.
Miscellaneous
.Pp
-.Bl -tag -xwidth ".Li -p1003.1g-2000" -compact -offset indent
+.Bl -tag -width ".Li -p1003.1g-2000" -compact -offset indent
.It Li -ieee754
.St -ieee754
.It Li -iso8802-3
@@ -1900,7 +1900,7 @@ section, it causes a line break (useful for old style variable declarations).
.Pp
.Dl Usage: .Vt Ao type Ac ...
.Pp
-.Bl -tag -xwidth ".Li .Vt\ extern\ char\ *optarg\ ;" -compact -offset 15n
+.Bl -tag -width ".Li .Vt\ extern\ char\ *optarg\ ;" -compact -offset 15n
.It Li ".Vt extern char *optarg ;"
.Vt extern char *optarg ;
.It Li ".Vt FILE *"
@@ -1913,7 +1913,7 @@ Generic variable reference.
.Pp
.Dl Usage: .Va Ao variable Ac ...
.Pp
-.Bl -tag -xwidth ".Li .Va\ Xchar\ sX\ ]\ )\ )\ ," -compact -offset 15n
+.Bl -tag -width ".Li .Va\ Xchar\ sX\ ]\ )\ )\ ," -compact -offset 15n
.It Li ".Va count"
.Va count
.It Li ".Va settimer ,"
@@ -1937,7 +1937,7 @@ put into parentheses.
.Pp
.Dl Usage: .Xr Ao man page name Ac Oo Ao section Ac Oc ...
.Pp
-.Bl -tag -xwidth ".Li .Xr\ xinit\ 1x\ ;" -compact -offset 15n
+.Bl -tag -width ".Li .Xr\ xinit\ 1x\ ;" -compact -offset 15n
.It Li ".Xr mdoc"
.Xr mdoc
.It Li ".Xr mdoc ,"
@@ -1959,7 +1959,7 @@ The default width is 10n.
.Pp
.Dl Usage: .At Oo Ao version Ac Oc ...
.Pp
-.Bl -tag -xwidth ".Li .At\ v6\ ." -compact -offset 15n
+.Bl -tag -width ".Li .At\ v6\ ." -compact -offset 15n
.It Li .At
.At
.It Li ".At v6 ."
@@ -1978,7 +1978,7 @@ are possible:
.Dl "Usage: .Bx" Bro -alpha | -beta | -devel Brc ...
.Dl " .Bx" Oo Ao version Ac Oo Ao release Ac Oc Oc ...
.Pp
-.Bl -tag -xwidth ".Li .Bx\ -devel" -compact -offset 15n
+.Bl -tag -width ".Li .Bx\ -devel" -compact -offset 15n
.It Li .Bx
.Bx
.It Li ".Bx 4.3 ."
@@ -2001,7 +2001,7 @@ are possible:
.Pp
.Dl Usage: .Nx Oo Ao version Ac Oc ...
.Pp
-.Bl -tag -xwidth ".Li .Nx\ 1.4\ ." -compact -offset 15n
+.Bl -tag -width ".Li .Nx\ 1.4\ ." -compact -offset 15n
.It Li .Nx
.Nx
.It Li ".Nx 1.4 ."
@@ -2020,7 +2020,7 @@ request above in section
.Pp
.Dl Usage: .Fx Oo Ao version Ac Oc ...
.Pp
-.Bl -tag -xwidth ".Li .Fx\ 2.2\ ." -compact -offset 15n
+.Bl -tag -width ".Li .Fx\ 2.2\ ." -compact -offset 15n
.It Li .Fx
.Fx
.It Li ".Fx 2.2 ."
@@ -2039,7 +2039,7 @@ request above in section
.Pp
.Dl Usage: .Ox Oo Ao version Ac Oc ...
.Pp
-.Bl -tag -xwidth ".Li .Ox\ 1.0" -compact -offset 15n
+.Bl -tag -width ".Li .Ox\ 1.0" -compact -offset 15n
.It Li ".Ox 1.0"
.Ox 1.0
.El
@@ -2049,7 +2049,7 @@ request above in section
.Pp
.Dl Usage: .Bsx Oo Ao version Ac Oc ...
.Pp
-.Bl -tag -xwidth ".Li .Bsx\ 1.0" -compact -offset 15n
+.Bl -tag -width ".Li .Bsx\ 1.0" -compact -offset 15n
.It Li ".Bsx 1.0"
.Bsx 1.0
.El
@@ -2059,7 +2059,7 @@ request above in section
.Pp
.Dl Usage: .Ux ...
.Pp
-.Bl -tag -xwidth ".Li .Ux" -compact -offset 15n
+.Bl -tag -width ".Li .Ux" -compact -offset 15n
.It Li .Ux
.Ux
.El
@@ -2073,7 +2073,7 @@ The usual font for emphasis is italic.
.Pp
.Dl Usage: .Em Ao argument Ac ...
.Pp
-.Bl -tag -xwidth ".Li .Em\ vide\ infra\ )\ )\ ," -compact -offset 15n
+.Bl -tag -width ".Li .Em\ vide\ infra\ )\ )\ ," -compact -offset 15n
.It Li ".Em does not"
.Em does not
.It Li ".Em exceed 1024 ."
@@ -2102,7 +2102,7 @@ has the following syntax:
.Ao font mode Ac
must be one of the following three types:
.Pp
-.Bl -tag -xwidth ".Sy \&Sy | Fl symbolic" -compact -offset indent
+.Bl -tag -width ".Sy \&Sy | Fl symbolic" -compact -offset indent
.It Sy \&Em | Fl emphasis
Same as if the
.Ql .Em
@@ -2161,7 +2161,7 @@ and
.Sq o
have a default width value of 12n.
.
-.Bl -tag -xwidth ".Li .Ec , .Eo"
+.Bl -tag -width ".Li .Ec , .Eo"
.It Li .Eo , .Ec
These macros expect the first argument to be the opening and closing strings
respectively.
@@ -2191,7 +2191,7 @@ The default width is 16n.
The prefix macro suppresses the whitespace between its first and second
argument:
.
-.Bl -tag -xwidth ".Li .Pf\ (\ Fa\ name2" -offset indent
+.Bl -tag -width ".Li .Pf\ (\ Fa\ name2" -offset indent
.It Li ".Pf ( Fa name2"
.Pf ( Fa name2
.El
@@ -2214,7 +2214,7 @@ mode.
Examples of quoting:
.
.Pp
-.Bl -tag -xwidth ".Li .Bq\ Em\ Greek\ ,\ French\ ." -compact -offset indent
+.Bl -tag -width ".Li .Bq\ Em\ Greek\ ,\ French\ ." -compact -offset indent
.It Li .Aq
.Aq
.It Li ".Aq Pa ctype.h ) ,"
@@ -2272,7 +2272,7 @@ if you really want that English word (and not the macro) as a parameter.
.Pp
.Dl Usage: .No Ao argument Ac ...
.Pp
-.Bl -tag -xwidth ".Li .No\ test\ Ta\ with\ Ta\ tabs" -compact -offset 15n
+.Bl -tag -width ".Li .No\ test\ Ta\ with\ Ta\ tabs" -compact -offset 15n
.It Li ".No test Ta with Ta tabs"
.No test Ta with Ta tabs
.El
@@ -2292,7 +2292,7 @@ space between the flag and argument:
.Dl "Usage:" ... Ao argument Ac \&Ns Oo Ao argument Ac Oc ...
.Dl " " .Ns Ao argument Ac ...
.Pp
-.Bl -tag -xwidth ".Li .Op\ Fl\ I\ Ns\ Ar\ directory" -compact -offset 15n
+.Bl -tag -width ".Li .Op\ Fl\ I\ Ns\ Ar\ directory" -compact -offset 15n
.It Li ".Op Fl I Ns Ar directory"
.Op Fl I Ns Ar directory
.El
@@ -2317,7 +2317,7 @@ macro designates a reference to a section header within the same document.
.Pp
.Dl Usage: .Sx Ao section reference Ac ...
.Pp
-.Bl -tag -xwidth ".Li .Sx\ FILES" -offset 15n
+.Bl -tag -width ".Li .Sx\ FILES" -offset 15n
.It Li ".Sx FILES"
.Sx FILES
.El
@@ -2332,7 +2332,7 @@ symbolic sense or the traditional English usage.
.Pp
.Dl Usage: .Sy Ao symbol Ac ...
.Pp
-.Bl -tag -xwidth ".Li .Sy\ Important\ Notice" -compact -offset 15n
+.Bl -tag -width ".Li .Sy\ Important\ Notice" -compact -offset 15n
.It Li ".Sy Important Notice"
.Sy Important Notice
.El
@@ -2346,7 +2346,7 @@ Use this macro for mathematical symbols and similar things.
.Pp
.Dl Usage: .Ms Ao math symbol Ac ...
.Pp
-.Bl -tag -xwidth ".Li .Ms\ sigma" -compact -offset 15n
+.Bl -tag -width ".Li .Ms\ sigma" -compact -offset 15n
.It Li ".Ms sigma"
.Ms sigma
.El
@@ -2446,7 +2446,7 @@ Its intended use is to imitate a small caps fonts for uppercase acronyms.
.Pp
.Dl Usage: .Tn Ao symbol Ac ...
.Pp
-.Bl -tag -xwidth ".Li .Tn\ ASCII" -compact -offset 15n
+.Bl -tag -width ".Li .Tn\ ASCII" -compact -offset 15n
.It Li ".Tn DEC"
.Tn DEC
.It Li ".Tn ASCII"
@@ -2571,7 +2571,7 @@ only; it then reactivates the default font for
.Pp
The default width is 8n.
.
-.Bl -tag -xwidth ".Li .Sh\ RETURN\ VALUES"
+.Bl -tag -width ".Li .Sh\ RETURN\ VALUES"
.It Li ".Sh NAME"
The
.Ql ".Sh NAME"
@@ -2686,7 +2686,7 @@ section headers are part of the preferred manual page layout and must be
used appropriately to maintain consistency.
They are listed in the order in which they would be used.
.
-.Bl -tag -xwidth ".Li .Sh\ COMPATIBILITY"
+.Bl -tag -width ".Li .Sh\ COMPATIBILITY"
.It Li ".Sh ENVIRONMENT"
The
.Sx ENVIRONMENT
@@ -2792,7 +2792,7 @@ The default width is 8n.
.
.Ss "Paragraphs and Line Spacing"
.
-.Bl -tag -xwidth ".Li .Pp"
+.Bl -tag -width ".Li .Pp"
.It Li .Pp
The
.Ql .Pp
@@ -2966,7 +2966,7 @@ option should be added.
.
There are seven types of displays.
.Pp
-.Bl -tag -xwidth ".Li .D1"
+.Bl -tag -width ".Li .D1"
.It Li .D1
(This is D-one.)
Display one line of indented text.
@@ -3004,14 +3004,14 @@ display must be ended with the
macro.
It has the following syntax:
.Pp
-.Bl -tag -xwidth ".Li .Bd" -offset indent
+.Bl -tag -width ".Li .Bd" -offset indent
.It Li .Bd Xo
.Bro \-literal | \-filled | \-unfilled | \-ragged | \-centered Brc
.Oo \-offset Ao string Ac Oc Oo \-file Ao file name Ac Oc Oo \-compact Oc Xc
.El
.Pp
.
-.Bl -tag -xwidth ".Fl file Ao Ar file name Ac " -compact
+.Bl -tag -width ".Fl file Ao Ar file name Ac " -compact
.It Fl ragged
Fill, but do not adjust the right margin (only left-justify).
.It Fl centered
@@ -3046,7 +3046,7 @@ is specified with one of the following strings, the string is interpreted to
indicate the level of indentation for the forthcoming block of text:
.
.Pp
-.Bl -tag -xwidth ".Ar indent-two" -compact
+.Bl -tag -width ".Ar indent-two" -compact
.It Ar left
Align block on the current left margin; this is the default mode of
.Ql .Bd .
@@ -3133,10 +3133,10 @@ Most of this document has been formatted with a tag style list
It has the following syntax forms:
.
.Pp
-.Bl -tag -xwidth ".Li .Bl" -offset indent -compact
+.Bl -tag -width ".Li .Bl" -offset indent -compact
.It Li .Bl Xo
.Bro \-hang | \-ohang | \-tag | \-diag | \-inset Brc
-.Oo \-width Ao string Ac Oc Oo \-xwidth Ao command Ac Oc
+.Oo \-width Ao string Ac Oc
.Oo \-offset Ao string Ac Oc Oo \-compact Oc Xc
.It Li .Bl Xo
.No \-column Oo \-offset Ao string Ac Oc
@@ -3150,7 +3150,7 @@ It has the following syntax forms:
And now a detailed description of the list types.
.
.Pp
-.Bl -tag -xwidth ".Fl column" -compact
+.Bl -tag -width ".Fl column" -compact
.It Fl bullet
A bullet list.
.
@@ -3298,8 +3298,6 @@ Item two here.
A list with tags.
Use
.Fl width
-or
-.Fl xwidth
to specify the tag width.
.
.Pp
@@ -3342,11 +3340,9 @@ numerical id of parent of process priority
.It Fl diag
Diag lists create section four diagnostic lists and are similar to inset
lists except callable macros are ignored.
-The flags
+The
.Fl width
-and
-.Fl xwidth
-are not meaningful in this context.
+flag is not meaningful in this context.
.Pp
Example:
.
@@ -3518,7 +3514,7 @@ was produced by:
.
Other keywords:
.
-.Bl -tag -xwidth ".Fl indent Ao Ar string Ac"
+.Bl -tag -width ".Fl indent Ao Ar string Ac"
.It Fl width Ao Ar string Ac
If
.Ao string Ac
@@ -3559,7 +3555,7 @@ is a callable macro, the default width for that macro will be used;
otherwise, the default width of
.Ql .No
is used.
-.It Fl xwidth Ao Ar string Ac
+.It Fl width Ao Ar string Ac
Interpret
.Ao string Ac
and use the width of the result.
@@ -3568,10 +3564,10 @@ Almost all lists in this document use this option.
Example:
.
.Bd -literal -offset indent
-\&.Bl -tag -xwidth ".Fl test Ao Ar string Ac"
+\&.Bl -tag -width ".Fl test Ao Ar string Ac"
\&.It Fl test Ao Ar string Ac
This is a longer sentence to show how the
-\&.Fl xwidth
+\&.Fl width
flag works in combination with a tag list.
\&.El
.Ed
@@ -3579,10 +3575,10 @@ flag works in combination with a tag list.
.
gives:
.
-.Bl -tag -xwidth ".Fl test Ao Ar string Ac"
+.Bl -tag -width ".Fl test Ao Ar string Ac"
.It Fl test Ao Ar string Ac
This is a longer sentence to show how the
-.Fl xwidth
+.Fl width
flag works in combination with a tag list.
.El
.Pp
@@ -3660,7 +3656,7 @@ properly please send a mail to
.Mt bug-groff@gnu.org
(including an example).
.
-.Bl -tag -xwidth ".Li .Bt"
+.Bl -tag -width ".Li .Bt"
.It Li .Bt
prints
.
OpenPOWER on IntegriCloud