added documentation and little changes in jsn.php with no effect improved test.php

Author: Tiboris

JSN-doc.pdf

@@ -341,6 +341,10 @@ function check_name($name, $replacement, $allow_replace)
     {
         err(2); // problem with reading input file
     }
+    if( ! is_object( $json_input = @ json_decode($json_input, false) ) && ! is_array($json_input) ) 
+    {
+        err(4); // bad json
+    }
     if ( ( $xml_output = @ fopen($args['output'], 'w')) === false ) 
     {
         err(3); // problem with writing to file
@@ -349,10 +353,6 @@ function check_name($name, $replacement, $allow_replace)
     {
         @ fclose($xml_output);
     }
-    if( ! is_object( $json_input = @ json_decode($json_input, false) ) && ! is_array($json_input) ) 
-    {
-        err(4); // bad json
-    }
     // starting function writer
     @ write($json_input, $args);
     // end of script    

jsn.php

@@ -67,6 +67,14 @@ function diffArrays($aArray1, $aArray2)
         { # code from commands
             echo "[ERR] Test " . $name . " failed with code: " . $returnCode . " expected: " . $code . "\n";
             $bad++;
+            if ( $bad == 1) 
+            {
+                $failedTests .= "$name";
+            } 
+            else
+            {
+                $failedTests .= ", $name";
+            }
             continue;
         } 
         elseif ($returnCode == $code && $returnCode != 0)