Fix docstrings

Author: ehrenfeu

src/imcflibs/pathtools.py

@@ -142,7 +142,7 @@ def parse_path(path, prefix=""):
 
 
 def join2(path1, path2):
-    """Join two paths into one, much like os.path.join().
+    r"""Join two paths into one, much like os.path.join().
 
     The main difference is that `join2()` takes exactly two arguments, but they
     can be non-str (as long as they're having a `__str__()` method), so this is
@@ -358,12 +358,12 @@ def folder_size(source):
 
 
 def create_directory(new_path):
-    """create a new directory if it does not already exist
+    """create a new directory if it does not already exist.
 
     Parameters
     ----------
     new_path : str
-        Path to the new directory
+        Path to the new directory.
     """
     if not os.path.exists(new_path):
         os.makedirs(new_path)

src/imcflibs/strtools.py

@@ -14,6 +14,11 @@ def _is_string_like(obj):
     instance of it (or a subclass thereof). So it's more generic than using
     isinstance(obj, str).
 
+    Parameters
+    ----------
+    obj : any
+        The object to be checked for being string-like.
+
     Example
     -------
     >>> _is_string_like('foo')
@@ -41,6 +46,7 @@ def filename(name):
     Parameters
     ----------
     name : str or filehandle or java.io.File
+        The object to retrieve the filename from.
 
     Returns
     -------
@@ -78,6 +84,7 @@ def flatten(lst):
     Parameters
     ----------
     lst : list(str)
+        The list of strings to be flattened.
 
     Returns
     -------