Also, @codebrainz point is good, while at it the docs could be further improved. I'm not 100% sure we should advertise the very order of the signals, but if it can be useful I don't really see why not either (I doubt having it defined would prevent it to make some otherwise compatible changes in the future).