Some pod updates on home branch

As far as I can say the code works.

Added some notes on what I understood from the code in home branch.

More TODO:

* pod: EXAMPLES/ BUGS/CAVEATS/SEE ALSO Links
* t/