[svn-commits] rmudgett: branch rmudgett/ao2_red_black r346143 - /team/rmudgett/ao2_red_blac...

[SVN commits to the Digium repositories]

Author: rmudgett
Date: Wed Nov 23 13:42:50 2011
New Revision: 346143

URL: http://svnview.digium.com/svn/asterisk?view=rev&rev=346143
Log:
Add test description comments for linked lists.

Modified:
    team/rmudgett/ao2_red_black/tests/test_linkedlists.c

Modified: team/rmudgett/ao2_red_black/tests/test_linkedlists.c
URL: http://svnview.digium.com/svn/asterisk/team/rmudgett/ao2_red_black/tests/test_linkedlists.c?view=diff&rev=346143&r1=346142&r2=346143
==============================================================================
--- team/rmudgett/ao2_red_black/tests/test_linkedlists.c (original)
+++ team/rmudgett/ao2_red_black/tests/test_linkedlists.c Wed Nov 23 13:42:50 2011
@@ -174,14 +174,14 @@
 	}
 	MATCH_OR_FAIL(&test_list, "", buf);
 
-	/* ** */
+	/* Check empty list test */
 
 	if (!AST_LIST_EMPTY(&test_list)) {
 		ast_test_status_update(test, "List should be empty\n");
 		return AST_TEST_FAIL;
 	}
 
-	/* ** */
+	/* Insert tail and remove specific item tests. */
 
 	AST_LIST_INSERT_TAIL(&test_list, &a, list);
 	MATCH_OR_FAIL(&test_list, "A", buf);
@@ -217,7 +217,7 @@
 		return AST_TEST_FAIL;
 	}
 
-	/* ** */
+	/* Insert item after specific item tests */
 
 	AST_LIST_INSERT_HEAD(&test_list, &a, list);
 	MATCH_OR_FAIL(&test_list, "A", buf);
@@ -242,7 +242,7 @@
 		return AST_TEST_FAIL;
 	}
 
-	/* ** */
+	/* Append list test */
 
 	AST_LIST_INSERT_HEAD(&test_list, &a, list);
 	MATCH_OR_FAIL(&test_list, "A", buf);
@@ -264,7 +264,7 @@
 		return AST_TEST_FAIL;
 	}
 
-	/* ** */
+	/* Insert list after specific item in middle test */
 
 	AST_LIST_INSERT_HEAD(&test_list, &a, list);
 	MATCH_OR_FAIL(&test_list, "A", buf);
@@ -286,7 +286,7 @@
 		return AST_TEST_FAIL;
 	}
 
-	/* ** */
+	/* Insert list after specific item on end test */
 
 	AST_LIST_INSERT_HEAD(&test_list, &a, list);
 	MATCH_OR_FAIL(&test_list, "A", buf);
@@ -308,7 +308,7 @@
 		return AST_TEST_FAIL;
 	}
 
-	/* ** */
+	/* Safe traversal list modification tests */
 
 	AST_LIST_INSERT_HEAD(&test_list, &a, list);
 	MATCH_OR_FAIL(&test_list, "A", buf);
@@ -385,14 +385,14 @@
 	}
 	MATCH_OR_FAIL_DBL(&test_list, "", buf);
 
-	/* ** */
+	/* Check empty list test */
 
 	if (!AST_DLLIST_EMPTY(&test_list)) {
 		ast_test_status_update(test, "List should be empty\n");
 		return AST_TEST_FAIL;
 	}
 
-	/* ** */
+	/* Insert tail and remove specific item tests. */
 
 	AST_DLLIST_INSERT_TAIL(&test_list, &a, dbl_list);
 	MATCH_OR_FAIL_DBL(&test_list, "A", buf);
@@ -428,7 +428,7 @@
 		return AST_TEST_FAIL;
 	}
 
-	/* ** */
+	/* Insert item after and before specific item tests */
 
 	AST_DLLIST_INSERT_HEAD(&test_list, &a, dbl_list);
 	MATCH_OR_FAIL_DBL(&test_list, "A", buf);
@@ -466,7 +466,7 @@
 		return AST_TEST_FAIL;
 	}
 
-	/* ** */
+	/* Append list test */
 
 	AST_DLLIST_INSERT_HEAD(&test_list, &a, dbl_list);
 	MATCH_OR_FAIL_DBL(&test_list, "A", buf);
@@ -488,7 +488,10 @@
 		return AST_TEST_FAIL;
 	}
 
-	/* Traverse starting from first element */
+	/*
+	 * Safe traversal list modification tests
+	 * Traverse starting from first element
+	 */
 
 	AST_DLLIST_INSERT_HEAD(&test_list, &a, dbl_list);
 	MATCH_OR_FAIL_DBL(&test_list, "A", buf);
@@ -565,7 +568,10 @@
 		return AST_TEST_FAIL;
 	}
 
-	/* Traverse starting from last element */
+	/*
+	 * Safe traversal list modification tests
+	 * Traverse starting from last element
+	 */
 
 	AST_DLLIST_INSERT_HEAD(&test_list, &a, dbl_list);
 	MATCH_OR_FAIL_DBL(&test_list, "A", buf);