Clarify the functions and documents

python/tvm/contrib/cc.py

@@ -17,6 +17,7 @@
 """Util to invoke C/C++ compilers in the system."""
 # pylint: disable=invalid-name
 import sys
+import shutil
 import os
 import subprocess
 
@@ -93,7 +94,10 @@ def _linux_ar(output, inputs, ar):
     temp = _utils.tempdir()
     temp_output = temp.relpath(libname)
     cmd = [ar, "-crs", temp_output]
-    objects = _tar.untar_files(temp, inputs)
+
+    # handles the case where some input files are tar of objects
+    # unpack them and return the list of files inside
+    objects = _tar.normalize_file_list_by_unpacking_tars(temp, inputs)
 
     cmd += objects
     proc = subprocess.Popen(cmd, stdout=subprocess.PIPE, stderr=subprocess.STDOUT)
@@ -108,15 +112,19 @@ def _linux_ar(output, inputs, ar):
 
 
 def create_staticlib(output, inputs, ar=None):
-    """Create shared library.
+    """Create static library.
 
     Parameters
     ----------
     output : str
         The target shared library.
 
-    objects : List[str]
-        List of inputs files.
+    inputs : List[str]
+        List of inputs files. Each input file can be a tarball
+        of objects or an object file.
+
+    ar : Optional[str]
+        Path to the ar command to be used
     """
 
     if _is_linux_like():

python/tvm/contrib/tar.py

@@ -86,10 +86,11 @@ def untar(tar_file, directory):
         raise RuntimeError(msg)
 
 
-def untar_files(temp, file_list):
-    """Untar all tars in the list to temp dirs and return untarred list.
+def normalize_file_list_by_unpacking_tars(temp, file_list):
+    """Normalize the file list by unpack tar files and return files in tar.
 
-    When a filename is a tar, it will untar it into an unique dir in temp.
+    When a filename is a tar, it will untar it into an unique dir
+    in temp and return the list of files in the tar.
     When a filename is a normal file, it will be simply added to the list.
 
     This is useful to untar objects in tar and then turn