git: 39da6db9bc89 - main - ifconfig.8: Make the -f flag description compact

From: Mateusz Piotrowski <0mp_at_FreeBSD.org>
Date: Wed, 30 Mar 2022 13:01:36 UTC
The branch main has been updated by 0mp (doc, ports committer):

URL: https://cgit.FreeBSD.org/src/commit/?id=39da6db9bc8909dba5c2fefc2dd0d310b0c0206e

commit 39da6db9bc8909dba5c2fefc2dd0d310b0c0206e
Author:     Mateusz Piotrowski <0mp@FreeBSD.org>
AuthorDate: 2022-03-30 12:35:15 +0000
Commit:     Mateusz Piotrowski <0mp@FreeBSD.org>
CommitDate: 2022-03-30 12:58:39 +0000

    ifconfig.8: Make the -f flag description compact
    
    - Remove extraneous examples
    - Apply "-compact" to the list macros so that it is possible to fit the
      definitions of the types and formats in one terminal screen.
    
    MFC after:      2 weeks
---
 sbin/ifconfig/ifconfig.8 | 57 ++++++++++++++++++++++++------------------------
 1 file changed, 28 insertions(+), 29 deletions(-)

diff --git a/sbin/ifconfig/ifconfig.8 b/sbin/ifconfig/ifconfig.8
index b005373babb5..f5f92e86dbed 100644
--- a/sbin/ifconfig/ifconfig.8
+++ b/sbin/ifconfig/ifconfig.8
@@ -122,68 +122,67 @@ The
 and their associated
 .Ar format
 strings are:
+.Pp
 .Bl -tag -width ether
 .It Cm addr
 Adjust the display of inet and inet6 addresses:
-.Bl -tag -width default
+.Pp
+.Bl -tag -width default -compact
 .It Cm default
-Display inet and inet6 addresses in the default format,
+Default format,
 .Cm numeric
 .It Cm fqdn
-Display inet and inet6 addresses as fully qualified domain names
+Fully qualified domain names
 .Pq FQDN
 .It Cm host
-Display inet and inet6 addresses as unqualified hostnames
+Unqualified hostnames
 .It Cm numeric
-Display inet and inet6 addresses in numeric format
+Numeric format
 .El
 .It Cm ether
 Adjust the display of link-level ethernet (MAC) addresses:
-.Bl -tag -width default
+.Pp
+.Bl -tag -width default -compact
 .It Cm colon
 Separate address segments with a colon
 .It Cm dash
 Separate address segments with a dash
 .It Cm default
-Display ethernet addresses in the default format,
+Default format,
 .Cm colon
 .El
 .It Cm inet
 Adjust the display of inet address subnet masks:
-.Bl -tag -width default
+.Pp
+.Bl -tag -width default -compact
 .It Cm cidr
-Display subnet masks in CIDR notation, for example:
-.Dl 10.0.0.0/8
-or
-.Dl 203.0.113.224/26
+CIDR notation, for example:
+.Ql 203.0.113.224/26
 .It Cm default
-Display subnet masks in the default format,
+Default format,
 .Cm hex
 .It Cm dotted
-Display subnet masks in dotted quad notation, for example:
-.Dl 255.255.0.0
-or
-.Dl 255.255.255.192
+Dotted quad notation, for example:
+.Ql 255.255.255.192
 .It Cm hex
-Display subnet masks in hexadecimal, for example:
-.Dl 0xffff0000
-or
-.Dl 0xffffffc0
+Hexadecimal format, for example:
+.Ql 0xffffffc0
 .El
 .It Cm inet6
 Adjust the display of inet6 address prefixes (subnet masks):
-.Bl -tag -width default
+.Pp
+.Bl -tag -width default -compact
 .It Cm cidr
-Display subnet prefix in CIDR notation, for example:
-.Dl ::1/128
+CIDR notation, for example:
+.Ql ::1/128
 or
-.Dl fe80::1%lo0/64
+.Ql fe80::1%lo0/64
 .It Cm default
-Display subnet prefix in the default format
+Default format,
 .Cm numeric
-.It Sy numeric
-Display subnet prefix in integer format, for example:
-.Dl prefixlen 64
+.It Cm numeric
+Integer format, for example:
+.Ql prefixlen 64
 .El
 .El
 .It Fl G Ar groupname