Add documentation to array.h

and remove 2 useless parameters from array_splice and array_slice