core: splice docs contradict implementation

[pktpls]

The docs for splice() say it returns the element removed last or null, but it actually returns the modified array.

Which is correct?

Quick web search:

• JS's Array.splice() returns nothing
• C++'s std::list::splice returns nothing
• PHP's array_splice() returns an array of the removed elements