Added some examples to PHPDoc

Author: mikeschinkel

cli/tests/includes/assertions

@@ -1,13 +1,18 @@
 #!/usr/bin/env bash
 #
-# Tests if an express outputs a value that is equal.
-#
 # @TODO We need to write a lot more of these
 #
 
+#
+# eval<Criteria>() function expect an expression to eval() and then test/compare
+# test<Criteria>() function expect a value to test/compare.
+#
+
 #
 # Tests if the output of an expression is equal to the supplied value
 #
+# @example evalEquals "echo hello", "hello"
+#
 function evalEquals() {
  local expr="$1"
  local value="$2"
@@ -22,6 +27,9 @@ function evalEquals() {
 #
 # Tests if two values are equal.
 #
+# @example: testEquals "$(echo hello)", "hello"
+# @example: foo=xyz && testEquals "$foo", "xyz"
+#
 function testEquals() {
  local value1="$1"
  local value2="$2"