diff --git a/t/all-yall.t b/t/all-yall.t
index 7174e4b..947c753 100755
--- a/t/all-yall.t
+++ b/t/all-yall.t
@@ -6,7 +6,7 @@ use warnings;
 use lib "src";
 use Gitolite::Test;
 
-# basic tests
+# could anything be clearer than "all y'all"?
 # ----------------------------------------------------------------------
 
 try "plan 26";
diff --git a/t/deleg-1.t b/t/deleg-1.t
index 0bff0db..bf47d4a 100755
--- a/t/deleg-1.t
+++ b/t/deleg-1.t
@@ -6,7 +6,7 @@ use warnings;
 use lib "src";
 use Gitolite::Test;
 
-# basic tests
+# delegation tests -- part 1
 # ----------------------------------------------------------------------
 
 try "plan 55";
diff --git a/t/deleg-2.t b/t/deleg-2.t
index b98d144..8c5a400 100755
--- a/t/deleg-2.t
+++ b/t/deleg-2.t
@@ -6,7 +6,7 @@ use warnings;
 use lib "src";
 use Gitolite::Test;
 
-# basic tests
+# delegation tests -- part 2
 # ----------------------------------------------------------------------
 
 try "plan 56";
diff --git a/t/deny-rules.t b/t/deny-rules.t
index 2492887..9726ac7 100755
--- a/t/deny-rules.t
+++ b/t/deny-rules.t
@@ -6,7 +6,7 @@ use warnings;
 use lib "src";
 use Gitolite::Test;
 
-# branch permissions test
+# deny rules
 # ----------------------------------------------------------------------
 
 try "plan 11";
diff --git a/t/include-subconf.t b/t/include-subconf.t
index 7bb5b04..a5fc908 100755
--- a/t/include-subconf.t
+++ b/t/include-subconf.t
@@ -6,6 +6,9 @@ use warnings;
 use lib "src";
 use Gitolite::Test;
 
+# include and subconf
+# ----------------------------------------------------------------------
+
 try 'plan 37';
 
 confreset; confadd '
diff --git a/t/info.t b/t/info.t
index 22019e3..e0538d7 100755
--- a/t/info.t
+++ b/t/info.t
@@ -6,6 +6,9 @@ use warnings;
 use lib "src";
 use Gitolite::Test;
 
+# the info command
+# ----------------------------------------------------------------------
+
 try 'plan 39';
 
 try "## info";
diff --git a/t/listers.t b/t/listers.t
index 84add2f..b824dd8 100755
--- a/t/listers.t
+++ b/t/listers.t
@@ -6,6 +6,9 @@ use warnings;
 use lib "src";
 use Gitolite::Test;
 
+# the various list-* commands
+# ----------------------------------------------------------------------
+
 try 'plan 30';
 
 try "## info";
diff --git a/t/personal-branches.t b/t/personal-branches.t
index 04e911f..2c8e6fb 100755
--- a/t/personal-branches.t
+++ b/t/personal-branches.t
@@ -6,7 +6,7 @@ use warnings;
 use lib "src";
 use Gitolite::Test;
 
-# basic tests
+# personal branches
 # ----------------------------------------------------------------------
 
 try "plan 39";
diff --git a/t/ssh-authkeys.t b/t/ssh-authkeys.t
index e4454ee..fa11a6c 100755
--- a/t/ssh-authkeys.t
+++ b/t/ssh-authkeys.t
@@ -6,6 +6,9 @@ use warnings;
 use lib "src";
 use Gitolite::Test;
 
+# testing the (separate) authkeys handler
+# ----------------------------------------------------------------------
+
 $ENV{GL_BINDIR} = "$ENV{PWD}/src";
 
 my $ak = "$ENV{HOME}/.ssh/authorized_keys";
diff --git a/t/ssh-basic.t b/t/ssh-basic.t
index 62e9345..6d8a10a 100755
--- a/t/ssh-basic.t
+++ b/t/ssh-basic.t
@@ -7,6 +7,9 @@ use lib "src";
 use Gitolite::Common;
 use Gitolite::Test;
 
+# basic tests using ssh
+# ----------------------------------------------------------------------
+
 my $bd = `gitolite query-rc -n GL_BINDIR`;
 my $h  = $ENV{HOME};
 my $ab = `gitolite query-rc -n GL_ADMIN_BASE`;
diff --git a/t/vrefs-1.t b/t/vrefs-1.t
index 4512ab8..468a338 100755
--- a/t/vrefs-1.t
+++ b/t/vrefs-1.t
@@ -6,6 +6,9 @@ use warnings;
 use lib "src";
 use Gitolite::Test;
 
+# VREFs - part 1
+# ----------------------------------------------------------------------
+
 try "plan 90";
 
 put "conf/gitolite.conf", "
diff --git a/t/vrefs-2.t b/t/vrefs-2.t
index 3ff1037..b44af42 100755
--- a/t/vrefs-2.t
+++ b/t/vrefs-2.t
@@ -6,6 +6,9 @@ use warnings;
 use lib "src";
 use Gitolite::Test;
 
+# VREFs - part 2
+# ----------------------------------------------------------------------
+
 try "plan 74";
 
 put "../gitolite-admin/conf/gitolite.conf", "
diff --git a/t/wild-1.t b/t/wild-1.t
index 23ecc2d..2824e37 100755
--- a/t/wild-1.t
+++ b/t/wild-1.t
@@ -6,7 +6,7 @@ use warnings;
 use lib "src";
 use Gitolite::Test;
 
-# basic tests
+# wild repos - part 1
 # ----------------------------------------------------------------------
 
 try "plan 66";
diff --git a/t/wild-2.t b/t/wild-2.t
index 2d213c9..0e49538 100755
--- a/t/wild-2.t
+++ b/t/wild-2.t
@@ -6,7 +6,7 @@ use warnings;
 use lib "src";
 use Gitolite::Test;
 
-# basic tests
+# wild repos - part 2
 # ----------------------------------------------------------------------
 
 try "plan 65";