diff --git a/beets/mediafile.py b/beets/mediafile.py index 29b2c3ae7..491f61a3b 100644 --- a/beets/mediafile.py +++ b/beets/mediafile.py @@ -148,9 +148,15 @@ def _safe_cast(out_type, val): # Image coding for ASF/WMA. def _unpack_asf_image(data): - """Unpack image data from a WM/Picture tag. + """Unpack image data from a WM/Picture tag. Return a tuple + containing the MIME type, the raw image data, a type indicator, and + the image's description. + + This function is treated as "untrusted" and could throw all manner + of exceptions (out-of-bounds, etc.). We should clean this up + sometime so that the failure modes are well-defined. """ - (type, size) = struct.unpack_from("