git: 98a0d2283701 - main - pciconf.8: Reorganize slightly to handle additional modes

The branch main has been updated by jhb:

URL: https://cgit.FreeBSD.org/src/commit/?id=98a0d2283701e08353ce670c8023803c58a4994c

commit 98a0d2283701e08353ce670c8023803c58a4994c
Author:     John Baldwin <jhb@FreeBSD.org>
AuthorDate: 2026-03-10 16:50:52 +0000
Commit:     John Baldwin <jhb@FreeBSD.org>
CommitDate: 2026-03-10 16:50:52 +0000

    pciconf.8: Reorganize slightly to handle additional modes
    
    Move the description of the optional device argument earlier before
    describing individual command modes.
    
    Add a subsection for list mode and a second subsection for the other
    modes that work with a single device.
    
    Reviewed by:    imp
    Sponsored by:   Chelsio Communications
    Differential Revision:  https://reviews.freebsd.org/D55773
---
 usr.sbin/pciconf/pciconf.8 | 58 +++++++++++++++++++++-------------------------
 1 file changed, 27 insertions(+), 31 deletions(-)

diff --git a/usr.sbin/pciconf/pciconf.8 b/usr.sbin/pciconf/pciconf.8
index 6c67e9e50df6..c9cbe483a1ac 100644
--- a/usr.sbin/pciconf/pciconf.8
+++ b/usr.sbin/pciconf/pciconf.8
@@ -23,7 +23,7 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.Dd May 19, 2025
+.Dd March 10, 2026
 .Dt PCICONF 8
 .Os
 .Sh NAME
@@ -52,6 +52,31 @@ access to
 .Pa /dev/pci ,
 normally only the super-user.
 .Pp
+A
+.Ar device
+can be identified either by a device name if the device is
+attached to a driver or by a selector.
+Selectors identify a PCI device by its address in PCI config space and
+can take one of the following forms:
+.Pp
+.Bl -bullet -offset indent -compact
+.It
+.Li pci Ns Va domain Ns \&: Ns Va bus Ns \&: Ns Va device Ns \&: \
+Ns Va function Ns
+.It
+.Li pci Ns Va bus Ns \&: Ns Va device Ns \&: Ns Va function Ns
+.It
+.Li pci Ns Va bus Ns \&: Ns Va device Ns
+.El
+.Pp
+In the case of an abridged form, omitted selector components are assumed to be 0.
+An optional leading device name followed by @ and an optional final colon
+will be ignored; this is so that the first column in the output of
+.Nm
+.Fl l
+can be used without modification.
+All numbers are base 10.
+.Ss List Mode
 With the
 .Fl l
 option,
@@ -260,36 +285,7 @@ argument is given with the
 flag,
 .Nm
 will only list details about a single device instead of all devices.
-.Pp
-All invocations of
-.Nm
-except for
-.Fl l
-require a
-.Ar device .
-The device can be identified either by a device name if the device is
-attached to a driver or by a selector.
-Selectors identify a PCI device by its address in PCI config space and
-can take one of the following forms:
-.Pp
-.Bl -bullet -offset indent -compact
-.It
-.Li pci Ns Va domain Ns \&: Ns Va bus Ns \&: Ns Va device Ns \&: \
-Ns Va function Ns
-.It
-.Li pci Ns Va bus Ns \&: Ns Va device Ns \&: Ns Va function Ns
-.It
-.Li pci Ns Va bus Ns \&: Ns Va device Ns
-.El
-.Pp
-In the case of an abridged form, omitted selector components are assumed to be 0.
-An optional leading device name followed by @ and an optional final colon
-will be ignored; this is so that the first column in the output of
-.Nm
-.Fl l
-can be used without modification.
-All numbers are base 10.
-.Pp
+.Ss Device Information Modes
 With the
 .Fl a
 flag,