Update docs

README.md

@@ -22,7 +22,7 @@ Also, there are certain features not present in other solutions that would be pr
 Features and functionality that set it apart:
 
 * Uses the Python standard load(s)/dump(s) API.
-	* Can load filepaths, file-like objects and binary data (bytes-like objects).
+	* Can load filepaths, os.PathLike objects, file-like objects, and bytes-like objects.
 * Metadata objects look like a dict **and** act like a dict.
 	* Some common libraries shadow the representation of a dict
 	  and/or dict methods but do not behave like a dict.

docs/index.rst

@@ -22,7 +22,7 @@ The goals of audio-metadata are to provide a nice API and good UX while keeping
 Features and functionality that set it apart:
 
 * Uses the Python standard load(s)/dump(s) API.
-	* Can load filepaths, file-like objects and binary data (bytes-like objects).
+	* Can load filepaths, os.PathLike objects, file-like objects, and bytes-like objects.
 * Metadata objects look like a dict **and** act like a dict.
 	* Some common libraries shadow the representation of a dict
 	  and/or dict methods but do not behave like a dict.

src/audio_metadata/api.py

@@ -36,7 +36,7 @@ def determine_format(data):
 			or file-like object of an audio file.
 
 	Returns:
-		Format: An audio format class if supported, else None.
+		Format: An appropriate audio format class if supported, else None.
 	"""
 
 	# Only convert if not already a DataReader.
@@ -90,11 +90,13 @@ def load(f):
 			A filepath, path-like object or file-like object of an audio file.
 
 	Returns:
-		Format: An audio format object.
+		Format: An audio format object of the appropriate type.
 
 	Raises:
-		UnsupportedFormat: If file is not of a supported format.
-		ValueError: If filepath/file-like object is not valid or readable.
+		FormatError: If the audio file is not valid.
+		UnsupportedFormat: If the audio file is not of a supported format.
+		ValueError: If ``f`` is not a valid str, path-like object,
+			file-like object, or is unreadable.
 	"""
 
 	if (
@@ -125,10 +127,12 @@ def loads(b):
 		b (bytes-like object): A bytes-like object of an audio file.
 
 	Returns:
-		Format: An audio format object.
+		Format: An audio format object of the appropriate type.
 
 	Raises:
-		UnsupportedFormat: If file is not of a supported format.
+		FormatError: If the audio file is not valid.
+		UnsupportedFormat: If the audio file is not of a supported format.
+		ValueError: If ``b`` is not a valid bytes-like object.
 	"""
 
 	try: