updated documentation in header and for new functions - updated funct…

…ion name to be more accurate

README.md

@@ -29,10 +29,9 @@ Multiple files:
 ./w3c_validator.py index.html header.html styles/common.css
 ```
 
-All errors are printed in `STDERR`
+All errors are printed in `STDERR`; Exit status = # of errors (0 on success)
 
 
 ## References
 
 https://developer.mozilla.org/en-US/
-

w3c_validator.py

@@ -26,6 +26,8 @@
 
 All errors are printed in `STDERR`
 
+Return:
+Exit status is the # of errors, 0 on Success
 
 References
 
@@ -99,7 +101,9 @@ def __analyse(file_path):
     return nb_errors
 
 
-def __main_app():
+def __files_loop():
+    """Loop that analyses for each file from input arguments
+    """
     nb_errors = 0
     for file_path in sys.argv[1:]:
         nb_errors += __analyse(file_path)
@@ -116,4 +120,4 @@ def __main_app():
 
     """execute tests, then exit. Exit status = # of errors (0 on success)
     """
-    sys.exit(__main_app())
+    sys.exit(__files_loop())