3742 zfs comments need cleaner, more consistent style
Submitted by:   Will Andrews <willa@spectralogic.com>
Submitted by:   Alan Somers <alans@spectralogic.com>
Reviewed by:    Matthew Ahrens <mahrens@delphix.com>
Reviewed by:    George Wilson <george.wilson@delphix.com>
Reviewed by:    Eric Schrock <eric.schrock@delphix.com>

@@ -243,15 +243,16 @@
  * vdev_dirty() flags
  */
 #define VDD_METASLAB    0x01
 #define VDD_DTL         0x02
 
+/* Offset of embedded boot loader region on each label */
+#define VDEV_BOOT_OFFSET        (2 * sizeof (vdev_label_t))
 /*
- * Size and offset of embedded boot loader region on each label.
+ * Size of embedded boot loader region on each label.
  * The total size of the first two labels plus the boot area is 4MB.
  */
-#define VDEV_BOOT_OFFSET        (2 * sizeof (vdev_label_t))
 #define VDEV_BOOT_SIZE          (7ULL << 19)                    /* 3.5M */
 
 /*
  * Size of label regions at the start and end of each leaf device.
  */

@@ -315,12 +316,13 @@
 extern uint64_t vdev_default_asize(vdev_t *vd, uint64_t psize);
 extern uint64_t vdev_get_min_asize(vdev_t *vd);
 extern void vdev_set_min_asize(vdev_t *vd);
 
 /*
- * zdb uses this tunable, so it must be declared here to make lint happy.
+ * Global variables
  */
+/* zdb uses this tunable, so it must be declared here to make lint happy. */
 extern int zfs_vdev_cache_size;
 
 /*
  * The vdev_buf_t is used to translate between zio_t and buf_t, and back again.
  */