added exists_in_cache method

- Added _normalize_filename internal method, determines if a file
  argument is a File object or a scalar holding a filename
removed old comments, fixed POD docs