cache: Make the documentation for media_art_get_path() and _get_file() clearer

Also added some checks into the API and a return value to know if the function
was successful.

https://bugzilla.gnome.org/show_bug.cgi?id=734837
build: Fixed continuous build failure that was detected

AutoMake warning += vs = for EXTRA_DIST/CLEANFILES