It is not simply a bug. The documentation uses splice incorrectly but that example could be fixed by modifying $_[0] instead.

Fixing this short-coming really requires a change to the documented API. BrowserUk has already implemented that nicely. Now fix the documentation and address backward compatability and you can fix the module.