How does it work? about super_module

[AndyObtiva]

Could you provide a description of how this works in the README?

Done. I added a "How Does It Work?" section to the README.

I looked over the code briefly, and it appears to copy the singleton methods of the super module to the module the super module is included in. Is that correct?

You are correct though that only tells part of the story. Look through the README and the code for more details.

Note: I have always thought this should the common behavior of module inclusion.

I completely agree, which is why I am happy to have finally created this simple solution. I already offered to the Ruby language open-source project via a pull request: ruby/ruby#581
It was closed with the advice that I keep separate as a gem. If enough people want it to become part of the Ruby language though, we could perhaps propose inclusion directly in Ruby again given it has a very small footprint, it is tested, and is backwards compatible as an incremental solution, keeping inclusion of basic modules as is for older projects.

Thanks for raising this and good luck on using SuperModule.