From 05419da506c699f52d60cc7afe86263146778f87 Mon Sep 17 00:00:00 2001
From: Gordon Bergling <gbe@FreeBSD.org>
Date: Sat, 19 Dec 2020 10:11:37 +0000
Subject: [PATCH] bhnd(9): Fix a few mandoc related issues

- skipping paragraph macro: Pp before Bl
- skipping paragraph macro: Pp at the end of Ss
- missing section argument: Xr device_set_desc
- unusual Xr punctuation: none before bhnd_erom(9)

MFC after:	1 week
---
 share/man/man9/bhnd.9 | 21 +++------------------
 1 file changed, 3 insertions(+), 18 deletions(-)

diff --git a/share/man/man9/bhnd.9 b/share/man/man9/bhnd.9
index 8d68fdc6fe4..5cf37597304 100644
--- a/share/man/man9/bhnd.9
+++ b/share/man/man9/bhnd.9
@@ -715,7 +715,6 @@ per-core management registers.
 When BHND hardware is used as a host-connected peripheral (e.g., in a PCI Wi-Fi
 card), the on-chip peripheral controller core is configured to operate as
 an endpoint device, bridging access to the SoC hardware:
-.Pp
 .Bl -dash -offset indent
 .It
 Host access to SoC address space is provided via a set of register windows
@@ -925,7 +924,6 @@ A pointer to the bus
 If true, the resource requires bus window remapping before it is MMIO
 accessible.
 .El
-.Pp
 .\"
 .Ss "Bus Space Functions"
 The bhnd_bus_space functions wrap their equivalent
@@ -1116,7 +1114,6 @@ bus of device
 The returned
 .Vt bhnd_chipid
 struct contains the following fields:
-.Pp
 .Bl -tag -width "enum_addr" -offset indent
 .It Fa chip_id
 The chip identifier.
@@ -1320,7 +1317,6 @@ on success.
 The
 .Vt bhnd_board_info
 structure contains the following fields:
-.Pp
 .Bl -tag -width "board_srom_rev" -offset indent
 .It Fa board_vendor
 Vendor ID of the board manufacturer (PCI-SIG assigned).
@@ -1362,7 +1358,6 @@ fields will be populated from device NVRAM.
 .Pp
 Symbolic constants for common board flags are defined in
 .In dev/bhnd/bhnd_ids.h .
-.Pp
 .Ss "Device Matching Functions"
 The bhnd device matching functions are used to match against core, chip, and
 board-level device attributes.
@@ -1481,7 +1476,6 @@ is returned.
 A
 .Vt bhnd_board_match
 match descriptor may be initialized using one or more of the following macros:
-.Pp
 .Bl -tag -width "Fn BHND_MATCH_BOARD_VENDOR vendor" -offset indent
 .It Fn BHND_MATCH_BOARD_VENDOR "vendor"
 Match on boards with a vendor equal to
@@ -1518,7 +1512,6 @@ struct bhnd_board_match board_desc = {
 A
 .Vt bhnd_chip_match
 match descriptor may be initialized using one or more of the following macros:
-.Pp
 .Bl -tag -width "Fn BHND_MATCH_CHIP_IPR id pkg hwrev" -offset indent
 .It Fn BHND_MATCH_CHIP_ID "id"
 Match on chips with an ID equal to
@@ -1565,7 +1558,6 @@ struct bhnd_chip_match chip_desc = {
 A
 .Vt bhnd_core_match
 match descriptor may be initialized using one or more of the following macros:
-.Pp
 .Bl -tag -width "Fn BHND_MATCH_CORE_VENDOR vendor" -offset indent
 .It Fn BHND_MATCH_CORE_VENDOR "vendor"
 Match on cores with a vendor ID equal to
@@ -1711,7 +1703,6 @@ bridged backplane.
 A
 .Vt bhnd_device
 table entry may be initialized using one of the following macros:
-.Pp
 .Bl -ohang -offset indent
 .It Fn BHND_DEVICE "vendor" "device" "desc" "quirks" "flags"
 Match on devices with a vendor ID equal to
@@ -2242,7 +2233,6 @@ will be discarded.
 .Pp
 The following clocks are supported, and may be combined using bitwise OR to
 request multiple clocks:
-.Pp
 .Bl -tag -width ".Dv BHND_CLOCK_DYN" -offset indent
 .It BHND_CLOCK_DYN
 Dynamically select an appropriate clock source based on all outstanding clock
@@ -2454,7 +2444,7 @@ device identification of
 overriding the core name with the specified
 .Fa dev_name ,
 to populate the device's verbose description using
-.Xr device_set_desc .
+.Xr device_set_desc 9 .
 .Pp
 The
 .Fn bhnd_set_default_core_desc
@@ -2463,7 +2453,7 @@ function uses the
 device identification of
 .Fa dev
 to populate the device's verbose description using
-.Xr device_set_desc .
+.Xr device_set_desc 9 .
 .Pp
 The
 .Fn bhnd_vendor_name
@@ -2491,7 +2481,6 @@ functions return a pointer to
 on success, a null pointer otherwise.
 .\"
 .Ss "Device Configuration Functions"
-.Pp
 The
 .Fn bhnd_read_config
 and
@@ -2521,7 +2510,6 @@ and
 functions return 0 on success, otherwise an appropriate error code is returned.
 .\"
 .Ss "Device Information Functions"
-.Pp
 The
 .Fn bhnd_read_board_info
 function returns 0 on success, otherwise an appropriate error code is returned.
@@ -2542,7 +2530,6 @@ If fetching the requested DMA address translation otherwise fails, an
 appropriate error code will be returned.
 .\"
 .Ss "Interrupt Functions"
-.Pp
 The
 .Fn bhnd_get_intr_ivec
 function returns
@@ -2641,7 +2628,6 @@ The
 and
 .Fn bhnd_release_ext_rsrc
 functions return 0 on success, otherwise an appropriate error code is returned.
-.Pp
 .\"
 .Ss "Service Provider Functions"
 The
@@ -2664,14 +2650,13 @@ function returns a pointer to
 on success, a null pointer if the requested provider is not registered.
 .\"
 .Ss "Utility Functions"
-.Pp
 The
 .Fn bhnd_format_chip_id
 function returns the total number of bytes written on success, or a negative
 integer on failure.
 .\"
 .Sh SEE ALSO
-.Xr bhnd 4
+.Xr bhnd 4 ,
 .Xr bhnd_erom 9
 .Sh AUTHORS
 .An -nosplit
-- 
2.42.0