Hi,
On 9/11/25 12:55 AM, Ilpo Järvinen wrote:
> Fix the copy-pasted errors in the Resizable BAR handling functions
> kernel doc and generally improve wording choices.
>
> Fix the formatting errors of the Return: line.
>
> Signed-off-by: Ilpo Järvinen <ilpo.jarvi...@linux.intel.com>
> ---
> drivers/pci/rebar.c | 29 ++++++++++++++++++-----------
> 1 file changed, 18 insertions(+), 11 deletions(-)
>
> diff --git a/drivers/pci/rebar.c b/drivers/pci/rebar.c
> index 020ed7a1b3aa..64315dd8b6bb 100644
> --- a/drivers/pci/rebar.c
> +++ b/drivers/pci/rebar.c
> @@ -58,8 +58,9 @@ void pci_rebar_init(struct pci_dev *pdev)
> * @bar: BAR to find
> *
> * Helper to find the position of the ctrl register for a BAR.
> - * Returns -ENOTSUPP if resizable BARs are not supported at all.
> - * Returns -ENOENT if no ctrl register for the BAR could be found.
> + *
> + * Return: %-ENOTSUPP if resizable BARs are not supported at all,
> + * %-ENOENT if no ctrl register for the BAR could be found.
These 2 lines will run together in the (html) output. They could be
made "prettier" (IMO) into a 2-item list if you choose:
* Return:
* * %-ENOTSUPP if resizable BARs are not supported at all
* * %-ENOENT if no ctrl register for the BAR could be found
> */
> static int pci_rebar_find_pos(struct pci_dev *pdev, int bar)
> {
--
~Randy
