From nobody Wed Mar 30 13:01:36 2022 X-Original-To: dev-commits-src-main@mlmmj.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mlmmj.nyi.freebsd.org (Postfix) with ESMTP id EF9071A4214E; Wed, 30 Mar 2022 13:01:36 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (4096 bits) client-digest SHA256) (Client CN "mxrelay.nyi.freebsd.org", Issuer "R3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4KT65D5MpMz4ZgN; Wed, 30 Mar 2022 13:01:36 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1648645296; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=TUS9mcfDtOBTOwuDZMbWTLrMHVUs1hjm0NE9bTv60Co=; b=SoPYPDmGCVEBw5xHRhx19eQWoXuSvJzvcxXOlqkO9ieDzx2dglTmm5ngYWA52TuQTHzU39 5+Fddaxxh8e17dH9f9QFj5Bf3qMwknApaI0cxKv40lAy1JsUl9Vo0SH4EjmDH0qvX8Ucm3 9fEflk04BDiCFTjwwHcMvRfKbdWTZrV2jwzOMdLgEaPrKq2GpYlUd/SGsb7kqNgf2jMecM 8CTVGumx8CKU17nBAj1CKnOqScJcxKG6DGU687ub4a2oP4I1gXFpMWioUKuIaNHO5qddvJ GsFWx32TNskSFR23tjteEBDIRJhPa5e1VlF+BJQxEm+s7DNFbRA72tXUMOyWpg== Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (Client did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id 332D413B24; Wed, 30 Mar 2022 13:01:36 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.16.1/8.16.1) with ESMTP id 22UD1aHx098871; Wed, 30 Mar 2022 13:01:36 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 22UD1afR098870; Wed, 30 Mar 2022 13:01:36 GMT (envelope-from git) Date: Wed, 30 Mar 2022 13:01:36 GMT Message-Id: <202203301301.22UD1afR098870@gitrepo.freebsd.org> To: src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-main@FreeBSD.org From: Mateusz Piotrowski <0mp@FreeBSD.org> Subject: git: 39da6db9bc89 - main - ifconfig.8: Make the -f flag description compact List-Id: Commit messages for the main branch of the src repository List-Archive: https://lists.freebsd.org/archives/dev-commits-src-main List-Help: List-Post: List-Subscribe: List-Unsubscribe: Sender: owner-dev-commits-src-main@freebsd.org X-BeenThere: dev-commits-src-main@freebsd.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: 0mp X-Git-Repository: src X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 39da6db9bc8909dba5c2fefc2dd0d310b0c0206e Auto-Submitted: auto-generated ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1648645296; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=TUS9mcfDtOBTOwuDZMbWTLrMHVUs1hjm0NE9bTv60Co=; b=T4xVvX++Q/9Y4O95eUpo5VxgsFXrTkPesudJeJSuj2QUF7/2iVsY51u0jxXqUQGDrTCLUj QF+zoLCV8V/Ayvp0oEegSXCGBLTw+bZCGvC7fzaAv8h1pjcUHVy4fR/O696zxBq+78vZEP KOVZikWOu5ZeVtEpl10TsfSWDQ30KFvV3nLeH7AvslFCeLdX19Sp4Ej3jo7FtrUhS+BZ7w lpULcnhVRw+aHqsvT6Bd14P62Noml2txr94UnO5AMpoPekZSWCc+FfH1V0ebTePg7Ci/6Q cmoX9mIJNCQ2Gm2DQn6YAhXzff6lXOIcFbT6KRrI2R88yWu9x3i8gys6nqp8Dw== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1648645296; a=rsa-sha256; cv=none; b=gR4wr+gMDKc8M5am7KpM9+bmqJEQN53H9zo6N1yMbyHXCw/o3YRE1hDrXAgCM5xPUqNdoH h1hVbqmq4B6A1MIwXCHlQvCZmtx04VqnU8F8L39FPxgPiDEoP8+O53HInkgoj6159BWlPU J5Vb3R2FG7mdQ3uKptXPRGgnk86y8kXNNLxd5YKeX5el2QZRC6b85/YaN5kDzMWsI+IXIR liMIfgM9CchvQlRVhKAZuL5MdluFK/3kTjRTBhZKANHWSguR8TVX9Q0ufGbrANnP26fI1L zf19MrqTaZ4daIgInVDKBxLn0uGT5moO5lBXJv+4tNO2FnfFRMGCFnuBCP1ECw== ARC-Authentication-Results: i=1; mx1.freebsd.org; none X-ThisMailContainsUnwantedMimeParts: N 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