Add documentation. Return removed elements from ::splice.