Index: share/man/man5/style.mdoc.5
===================================================================
--- share/man/man5/style.mdoc.5
+++ share/man/man5/style.mdoc.5
@@ -26,7 +26,7 @@
 .\"
 .\" $FreeBSD$
 .\"
-.Dd December 3, 2021
+.Dd December 12, 2021
 .Dt STYLE.MDOC 5
 .Os
 .Sh NAME
@@ -121,6 +121,42 @@
 .El
 .Ed
 .El
+.Ss Lists
+.Bl -dash -width ""
+.It
+The
+.Fl width
+argument to the
+.Sy \&.Bl
+macro should match the length of the longest item in the list, e.g.:
+.Bd -literal -offset indent
+\&.Bl -tag -width "-a address"
+\&.It Fl a Ar address
+Set the address.
+\&.It Fl v
+Print the version.
+\&.El
+.Ed
+.Pp
+In case the longest item is too long and hurts readability,
+the recommendation is to set
+the
+.Fl width
+argument
+to
+.Ql indent ,
+e.g.:
+.Bd -literal -offset indent
+\&.Bl -tag -width "indent"
+\&.It Cm build
+Build the port.
+\&.It Cm install
+Install the port.
+\&.It Fl install-missing-packages
+Install the missing packages.
+\&.El
+.Ed
+.El
 .Ss Synopsis Formatting
 .Bl -dash -width ""
 .It