soc/intel/common/pcie_rp.h: Fix comment style

This change updates pcie_rp.h to reflow the comment blocks to fit
within 80 columns to match the original style of the file. This
addresses comment received on
CB:49370 (https://review.coreboot.org/c/coreboot/+/49370/comment/0f3fe10d_4e218b5f/).

Change-Id: I565ad602e0e3a2ee09e8345479d82e2ce0a31fd0
Signed-off-by: Furquan Shaikh <furquan@google.com>
Reviewed-on: https://review.coreboot.org/c/coreboot/+/49725
Tested-by: build bot (Jenkins) <no-reply@coreboot.org>
Reviewed-by: HAOUAS Elyes <ehaouas@noos.fr>
Reviewed-by: EricR Lai <ericr_lai@compal.corp-partner.google.com>
This commit is contained in:
Furquan Shaikh 2021-01-19 11:55:08 -08:00 committed by Patrick Georgi
parent 985821c4f2
commit 3b6b9c7b78
1 changed files with 14 additions and 14 deletions

View File

@ -10,10 +10,10 @@
* functions. * functions.
* *
* `slot` is the PCI device/slot number of such a group. * `slot` is the PCI device/slot number of such a group.
* `start` is the initial PCI function number within the group. This is useful in case the * `start` is the initial PCI function number within the group. This is useful
* root port numbers are not contiguous within the slot. * in case the root port numbers are not contiguous within the slot.
* `count` is the number of functions within the group starting with the `start` function * `count` is the number of functions within the group starting with the `start`
* number. * function number.
*/ */
struct pcie_rp_group { struct pcie_rp_group {
unsigned int slot; unsigned int slot;
@ -44,22 +44,22 @@ static inline unsigned int rp_end_fn(const struct pcie_rp_group *group)
* Call this once, after root ports have been reordered, but before PCI * Call this once, after root ports have been reordered, but before PCI
* enumeration. * enumeration.
* *
* `groups` points to a list of groups terminated by an entry with `count == 0`. It is assumed * `groups` points to a list of groups terminated by an entry with `count == 0`.
* that the first group includes the RPs 1 to the first group's `count` and that adjacent groups * It is assumed that the first group includes the RPs 1 to the first group's
* follow without gaps in the numbering. * `count` and that adjacent groups follow without gaps in the numbering.
*/ */
void pcie_rp_update_devicetree(const struct pcie_rp_group *groups); void pcie_rp_update_devicetree(const struct pcie_rp_group *groups);
/* /*
* Return mask of PCIe root ports that are enabled by mainboard. Mask is set in the same order * Return mask of PCIe root ports that are enabled by mainboard. Mask is set in
* as the root ports in pcie_rp_group groups table. * the same order as the root ports in pcie_rp_group groups table.
* *
* Thus, the status of first root port in the groups table is indicated by bit 0 in the returned * Thus, the status of first root port in the groups table is indicated by bit 0
* mask, second root port by bit 1 and so on. * in the returned mask, second root port by bit 1 and so on.
* 1 in the bit position indicates root port is enabled, whereas 0 indicates root port is * 1 in the bit position indicates root port is enabled, whereas 0 indicates root
* disabled. This function assumes that the maximum count of root ports in the groups table is * port is disabled. This function assumes that the maximum count of root ports
* <= 32. * in the groups table is <= 32.
*/ */
uint32_t pcie_rp_enable_mask(const struct pcie_rp_group *groups); uint32_t pcie_rp_enable_mask(const struct pcie_rp_group *groups);