Document split().

Also fix a small list_insert() comment nit.