* @test_index:                Starting index of the test
  * @strings:           Ethtool strings, or %NULL
  * @data:              Ethtool test results, or %NULL
+ *
+ * Fill in a block of loopback self-test entries.  Return new test
+ * index.
  */
 static int efx_fill_loopback_test(struct efx_nic *efx,
                                  struct efx_loopback_self_tests *lb_tests,
  * @tests:             Efx self-test results structure, or %NULL
  * @strings:           Ethtool strings, or %NULL
  * @data:              Ethtool test results, or %NULL
+ *
+ * Get self-test number of strings, strings, and/or test results.
+ * Return number of strings (== number of test results).
+ *
+ * The reason for merging these three functions is to make sure that
+ * they can never be inconsistent.
  */
 static int efx_ethtool_fill_self_tests(struct efx_nic *efx,
                                       struct efx_self_tests *tests,
 {
        struct efx_nic *efx = netdev_priv(net_dev);
        struct efx_self_tests *efx_tests;
-       int already_up;
+       bool already_up;
        int rc = -ENOMEM;
 
        efx_tests = kzalloc(sizeof(*efx_tests), GFP_KERNEL);
 
        if (efx->state != STATE_READY) {
                rc = -EIO;
-               goto fail1;
+               goto out;
        }
 
        netif_info(efx, drv, efx->net_dev, "starting %sline testing\n",
                if (rc) {
                        netif_err(efx, drv, efx->net_dev,
                                  "failed opening device.\n");
-                       goto fail1;
+                       goto out;
                }
        }
 
                   rc == 0 ? "passed" : "failed",
                   (test->flags & ETH_TEST_FL_OFFLINE) ? "off" : "on");
 
-fail1:
-       /* Fill ethtool results structures */
+out:
        efx_ethtool_fill_self_tests(efx, efx_tests, NULL, data);
        kfree(efx_tests);
 fail: