[PATCH] splice: add comments documenting more of the code