Can't the major complaints be addressed by just moving all this to the bottom of the file?

  # foo.py: objects that manage the interaction between foos and bars
  # (see eof for license and detailed description)