Wow this became the big ass comment commit. Hopeefully this will help
someone when trying to understand the plugin.