Refine trace command descriptions

Updated the trace command files to specify required operations
explicitly. Improved documentation without modifying test data.

Change-Id: If8ef44171bb5cc3cfee812d74cc33d55f6f1320b

Author: Dennis40816

README.md

@@ -111,6 +111,8 @@ Trace files
   * They are short and simple.
   * We encourage to study them to see what tests are being performed.
   * XX is the trace number (1-17).  CAT describes the general nature of the test.
+  * All functions that need to be implemented are explicitly listed.
+  * If a colon is present in the title, all functions mentioned afterwards must be correctly implemented for the test to pass.
 * `traces/trace-eg.cmd` : A simple, documented trace file to demonstrate the operation of `qtest`
 
 ## Debugging Facilities

traces/trace-01-ops.cmd

@@ -1,4 +1,4 @@
-# Test of insert_head and remove_head
+# Test of 'q_new', 'q_insert_head', and 'q_remove_head'
 option fail 0
 option malloc 0
 new

traces/trace-02-ops.cmd

@@ -1,4 +1,4 @@
-# Test of insert_head, insert_tail, remove_head, remove_tail, and delete_mid
+# Test of 'q_new', 'q_insert_head', 'q_insert_tail', 'q_remove_head', 'q_remove_tail', and 'q_delete_mid'
 option fail 0
 option malloc 0
 new

traces/trace-03-ops.cmd

@@ -1,4 +1,4 @@
-# Test of insert_head, insert_tail, remove_head, reverse and merge
+# Test of 'q_new', 'q_insert_head', 'q_remove_head', 'q_reverse', 'q_sort', and 'q_merge'
 option fail 0
 option malloc 0
 new

traces/trace-04-ops.cmd

@@ -1,4 +1,4 @@
-# Test of insert_head, insert_tail, size, swap, and sort
+# Test of 'q_new', 'q_insert_tail', 'q_insert_head', 'q_remove_head', 'q_size', 'q_swap', and 'q_sort'
 option fail 0
 option malloc 0
 new

traces/trace-05-ops.cmd

@@ -1,4 +1,4 @@
-# Test of insert_head, insert_tail, remove_head, reverse, size, swap, and sort
+# Test of 'q_new', 'q_free', 'q_insert_head', 'q_insert_tail', 'q_remove_head', 'q_reverse', 'q_size', 'q_swap', and 'q_sort'
 option fail 0
 option malloc 0
 new

traces/trace-06-ops.cmd

@@ -1,4 +1,4 @@
-# Test of insert_head, insert_tail, delete duplicate, sort, descend and reverseK
+# Test of 'q_new', 'q_free', 'q_insert_head', 'q_insert_tail', 'q_remove_head', 'q_delete_dup', 'q_sort', 'q_descend', and 'q_reverseK'
 new
 ih RAND 4
 it gerbil 3

traces/trace-07-string.cmd

@@ -1,4 +1,4 @@
-# Test of truncated strings
+# Test of truncated strings: 'q_new', 'q_free', 'q_insert_head', 'q_insert_tail', 'q_remove_head', 'q_reverse', and 'q_sort'
 option fail 0
 option malloc 0
 new

traces/trace-08-robust.cmd

@@ -1,4 +1,4 @@
-# Test operations on empty queue
+# Test operations on empty queue: 'q_new', 'q_remove_head', 'q_reverse', 'q_size', and 'q_sort'
 option fail 10
 option malloc 0
 new

traces/trace-09-robust.cmd

@@ -1,4 +1,4 @@
-# Test remove_head with NULL argument
+# Test 'q_remove_head' with NULL argument: 'q_new', 'q_insert_head', and 'q_remove_head'
 option fail 10
 option malloc 0
 new