Re: [PATCH 1/8] sata_mv more cosmetics

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



Mark Lord wrote:


applied patches 1-8...



@@ -1789,30 +1794,28 @@
    struct mv_host_priv *hpriv = host->private_data;
    unsigned int hc, handled = 0, n_hcs;
    void __iomem *mmio = hpriv->base;
-    u32 irq_stat, irq_mask;
+    u32 main_cause, main_mask;

-    /* Note to self: &host->lock == &ap->host->lock == ap->lock */
    spin_lock(&host->lock);
-
-    irq_stat = readl(hpriv->main_cause_reg_addr);
-    irq_mask = readl(hpriv->main_mask_reg_addr);
-
-    /* check the cases where we either have nothing pending or have read
-     * a bogus register value which can indicate HW removal or PCI fault
+    main_cause = readl(hpriv->main_cause_reg_addr);
+    main_mask  = readl(hpriv->main_mask_reg_addr);
+    /*
+     * Deal with cases where we either have nothing pending, or have read
+     * a bogus register value which can indicate HW removal or PCI fault.
     */

...but I am sad to see this. irq_stat and irq_mask naming make the driver more accessible to outsiders, because the purpose of the registers is immediately apparent even without having the docs at hand -- which is the case for everybody in the world except me and you :)

I applied the patch anyway because you are defacto maintainer of sata_mv.

However, I _request_ a reconsideration of some of these renames when viewed in that light. It's your prerogative as maintainer to ignore or honor that request as you see fit... We all have to balance making our own job easier with making the driver accessible to outsiders, particularly those without NDA'd docs.

	Jeff



--
To unsubscribe from this list: send the line "unsubscribe linux-ide" in
the body of a message to majordomo@xxxxxxxxxxxxxxx
More majordomo info at  http://vger.kernel.org/majordomo-info.html

[Index of Archives]     [Linux Filesystems]     [Linux SCSI]     [Linux RAID]     [Git]     [Kernel Newbies]     [Linux Newbie]     [Security]     [Netfilter]     [Bugtraq]     [Yosemite News]     [MIPS Linux]     [ARM Linux]     [Linux Security]     [Samba]     [Device Mapper]

  Powered by Linux