git: 19ac0bc5c139 - main - ifconfig.8: Simplify examples by using canonical parameters

From: Mateusz Piotrowski <0mp_at_FreeBSD.org>
Date: Thu, 31 Mar 2022 09:55:55 UTC
The branch main has been updated by 0mp (doc, ports committer):

URL: https://cgit.FreeBSD.org/src/commit/?id=19ac0bc5c139cdd00b71e1774ef327fa79197c2a

commit 19ac0bc5c139cdd00b71e1774ef327fa79197c2a
Author:     Mateusz Piotrowski <0mp@FreeBSD.org>
AuthorDate: 2022-03-31 09:54:06 +0000
Commit:     Mateusz Piotrowski <0mp@FreeBSD.org>
CommitDate: 2022-03-31 09:54:06 +0000

    ifconfig.8: Simplify examples by using canonical parameters
    
    Also, use Bd instead of Dl for multi line examples.
    
    MFC after:      2 weeks
---
 sbin/ifconfig/ifconfig.8 | 22 ++++++++--------------
 1 file changed, 8 insertions(+), 14 deletions(-)

diff --git a/sbin/ifconfig/ifconfig.8 b/sbin/ifconfig/ifconfig.8
index 2125f5e33394..4d9fb461a4d6 100644
--- a/sbin/ifconfig/ifconfig.8
+++ b/sbin/ifconfig/ifconfig.8
@@ -3091,12 +3091,8 @@ Add the IPv4 address
 with the CIDR network prefix
 .Li /28 ,
 to the interface
-.Li em0 ,
-using
-.Cm add
-as a synonym for the canonical form of the option
-.Cm alias :
-.Dl # ifconfig em0 inet 192.0.2.45/28 add
+.Li em0 :
+.Dl # ifconfig em0 inet 192.0.2.45/28 alias
 .Pp
 Remove the IPv4 address
 .Li 192.0.2.45
@@ -3117,17 +3113,15 @@ Note that lower case hexadecimal IPv6 addresses are acceptable.
 Remove the IPv6 address added in the above example,
 using the
 .Li /
-character as shorthand for the network prefix,
-and using
-.Cm delete
-as a synonym for the canonical form of the option
-.Fl alias :
-.Dl # ifconfig em0 inet6 2001:db8:bdbd::123/48 delete
+character as shorthand for the network prefix:
+.Dl # ifconfig em0 inet6 2001:db8:bdbd::123/48 -alias
 .Pp
 Configure a single CARP redundant address on igb0, and then switch it
 to be master:
-.Dl # ifconfig igb0 vhid 1 10.0.0.1/24 pass foobar up
-.Dl # ifconfig igb0 vhid 1 state master
+.Bd -literal -offset indent -compact
+# ifconfig igb0 vhid 1 10.0.0.1/24 pass foobar up
+# ifconfig igb0 vhid 1 state master
+.Ed
 .Pp
 Configure the interface
 .Li xl0 ,