docs: def multi_path_generator(pathnames):
      """
      yields (name,chunkgen) for all of the files found under the list
      of pathnames given. This is recursive, so directories will have
      their contents emitted. chunkgen is a function that can called and
      iterated over to obtain the contents of the file in multiple
      reads.
      """
  
      for pathname in pathnames:
          if isdir(pathname):
              for entry in directory_generator(pathname):
                  yield entry
          else:
              yield pathname, file_chunk(pathname)