D33394.1789168576.diff
No OneTemporary
Actions

Size

1 KB

Referenced Files

None

Subscribers

None

D33394.1789168576.diff
View Options

	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