PCI: Tidy comments
authorPranay Sanghai <pranaysanghai@gmail.com>
Sat, 18 Sep 2021 20:18:02 +0000 (13:18 -0700)
committerBjorn Helgaas <bhelgaas@google.com>
Tue, 28 Sep 2021 18:43:17 +0000 (13:43 -0500)
Make comments follow multi-line comment conventions. No functional change
intended.

Link: https://lore.kernel.org/r/YUZJenW2UCA4Qu0O@pranay-desktop
Signed-off-by: Pranay Sanghai <pranaysanghai@gmail.com>
Signed-off-by: Bjorn Helgaas <bhelgaas@google.com>
drivers/pci/setup-irq.c

index 7129494754dd7396000789f0e2e297365d639f79..cc7d26b015f328ec4026703bb0c7886d80b635b9 100644 (file)
@@ -8,7 +8,6 @@
  *     David Miller (davem@redhat.com)
  */
 
-
 #include <linux/kernel.h>
 #include <linux/pci.h>
 #include <linux/errno.h>
@@ -28,25 +27,26 @@ void pci_assign_irq(struct pci_dev *dev)
                return;
        }
 
-       /* If this device is not on the primary bus, we need to figure out
-          which interrupt pin it will come in on.   We know which slot it
-          will come in on 'cos that slot is where the bridge is.   Each
-          time the interrupt line passes through a PCI-PCI bridge we must
-          apply the swizzle function.  */
-
+       /*
+        * If this device is not on the primary bus, we need to figure out
+        * which interrupt pin it will come in on. We know which slot it
+        * will come in on because that slot is where the bridge is. Each
+        * time the interrupt line passes through a PCI-PCI bridge we must
+        * apply the swizzle function.
+        */
        pci_read_config_byte(dev, PCI_INTERRUPT_PIN, &pin);
        /* Cope with illegal. */
        if (pin > 4)
                pin = 1;
 
        if (pin) {
-               /* Follow the chain of bridges, swizzling as we go.  */
+               /* Follow the chain of bridges, swizzling as we go. */
                if (hbrg->swizzle_irq)
                        slot = (*(hbrg->swizzle_irq))(dev, &pin);
 
                /*
-                * If a swizzling function is not used map_irq must
-                * ignore slot
+                * If a swizzling function is not used, map_irq() must
+                * ignore slot.
                 */
                irq = (*(hbrg->map_irq))(dev, slot, pin);
                if (irq == -1)
@@ -56,7 +56,9 @@ void pci_assign_irq(struct pci_dev *dev)
 
        pci_dbg(dev, "assign IRQ: got %d\n", dev->irq);
 
-       /* Always tell the device, so the driver knows what is
-          the real IRQ to use; the device does not use it. */
+       /*
+        * Always tell the device, so the driver knows what is the real IRQ
+        * to use; the device does not use it.
+        */
        pci_write_config_byte(dev, PCI_INTERRUPT_LINE, irq);
 }