How files are installed by the Plugin Manager

I received a request a couple weeks ago to explain specifically how the Plugin Manager works. So, here is the list of rules that it currently follows when installing a plugin:

• If the file ends in .pl:
  • Evaluate it
  • Test to see if it creating any tags or filters using the regular plugin API
    • If so, place the file in the plugins/ directory
    • Otherwise, place it in the base directory
• If the file ends in .doc, .htm, .html, or .txt:
  • Place the file in the plugins/docs/Plugin-Name/ directory
• If the file ends in .pm:
  • Attempt to extract a package name (e.g. package A::B::C;)
  • Place the file based on the package name in the extlib/ directory (e.g extlib/A/B/C.pm)
• Otherwise, place it in the plugins/docs/Plugin-Name/ directory