Very good questions. I can only suggest that you read the code and explain to us what actually happens, and then we can argue about that, and then maybe you can send a patch for the docs. (really, I am not kidding).
Attachment:
pgpKd7jOdCOiN.pgp
Description: PGP signature