added path-handling functions; documentation
added path-handling functions; documentation

--HG--
extra : convert_revision : svn%3A41726ec3-264d-0410-9c23-a9f1637257cc/trunk%40144

ruippeixotog/beets,sadatay/beets,parapente/beets,mathstuf/beets,drm00/beets,kareemallen/beets,gabrielaraujof/beets,ruippeixotog/beets,jcoady9/beets,asteven/beets,gabrielaraujof/beets,arabenjamin/beets,ruippeixotog/beets,ibmibmibm/beets,shamangeorge/beets,swt30/beets,madmouser1/beets,MyTunesFreeMusic/privacy-policy,mclearc/beets,untitaker/beets,jbaiter/beets,Dishwishy/beets,ttsda/beets,sampsyo/beets,untitaker/beets,shanemikel/beets,beetbox/beets,ibmibmibm/beets,sampsyo/beets,pkess/beets,dfc/beets,randybias/beets,mathstuf/beets,marcuskrahl/beets,multikatt/beets,lengtche/beets,Freso/beets,jbaiter/beets,sampsyo/beets,PierreRust/beets,mathstuf/beets,Wen777/beets,madmouser1/beets,jcoady9/beets,diego-plan9/beets,diego-plan9/beets,gabrielaraujof/beets,tima/beets,xsteadfastx/beets,mosesfistos1/beetbox,beetbox/beets,dfc/beets,beetbox/beets,xsteadfastx/beets,Andypsamp/CODjunit,kelvinhammond/beets,aspidites/beets,Dishwishy/beets,drm00/beets,YetAnotherNerd/beets,ttsda/beets,kelvinhammond/beets,diego-plan9/beets,PierreRust/beets,lengtche/beets,Andypsamp/CODjunit,Andypsamp/CODfinalJUNIT,MyTunesFreeMusic/privacy-policy,Wen777/beets,shanemikel/beets,Dishwishy/beets,arabenjamin/beets,drm00/beets,Kraymer/beets,Dishwishy/beets,bj-yinyan/beets,mclearc/beets,lightwang1/beets,Andypsamp/CODfinalJUNIT,dfc/beets,mosesfistos1/beetbox,parapente/beets,diego-plan9/beets,aspidites/beets,shanemikel/beets,shanemikel/beets,pdf/beets,jackwilsdon/beets,PierreRust/beets,Freso/beets,jmwatte/beets,ngokevin/beets,untitaker/beets,kelvinhammond/beets,moodboom/beets,lengtche/beets,jackwilsdon/beets,Wen777/beets,pkess/beets,m-urban/beets,multikatt/beets,swt30/beets,kareemallen/beets,andremiller/beets,xsteadfastx/beets,LordSputnik/beets,Andypsamp/CODjunit,madmouser1/beets,asteven/beets,jcoady9/beets,SusannaMaria/beets,jmwatte/beets,SusannaMaria/beets,mosesfistos1/beetbox,sadatay/beets,madmouser1/beets,mosesfistos1/beetbox,m-urban/beets,Freso/beets,lightwang1/beets,jmwatte/beets,bj-yinyan/beets,Freso/beets,artemutin/beets,YetAnotherNerd/beets,multikatt/beets,asteven/beets,moodboom/beets,jmwatte/beets,MyTunesFreeMusic/privacy-policy,ruippeixotog/beets,shamangeorge/beets,ibmibmibm/beets,MyTunesFreeMusic/privacy-policy,randybias/beets,jayme-github/beets,swt30/beets,Andypsamp/CODfinalJUNIT,lightwang1/beets,artemutin/beets,arabenjamin/beets,gabrielaraujof/beets,LordSputnik/beets,SusannaMaria/beets,moodboom/beets,lightwang1/beets,bj-yinyan/beets,krig/beets,andremiller/beets,marcuskrahl/beets,pkess/beets,swt30/beets,drm00/beets,mathstuf/beets,parapente/beets,sadatay/beets,artemutin/beets,mried/beets,Andypsamp/CODfinalJUNIT,sampsyo/beets,Kraymer/beets,kelvinhammond/beets,jayme-github/beets,multikatt/beets,mried/beets,mried/beets,pdf/beets,m-urban/beets,ttsda/beets,Kraymer/beets,jcoady9/beets,imsparsh/beets,YetAnotherNerd/beets,LordSputnik/beets,asteven/beets,Andypsamp/CODjunit,jackwilsdon/beets,shamangeorge/beets,randybias/beets,YetAnotherNerd/beets,ttsda/beets,tima/beets,marcuskrahl/beets,shamangeorge/beets,artemutin/beets,randybias/beets,bj-yinyan/beets,mried/beets,SusannaMaria/beets,m-urban/beets,jackwilsdon/beets,marcuskrahl/beets,ngokevin/beets,kareemallen/beets,mclearc/beets,dfc/beets,xsteadfastx/beets,imsparsh/beets,parapente/beets,andremiller/beets,untitaker/beets,tima/beets,lengtche/beets,ibmibmibm/beets,Kraymer/beets,imsparsh/beets,Andypsamp/CODfinalJUNIT,moodboom/beets,tima/beets,arabenjamin/beets,LordSputnik/beets,Andypsamp/CODjunit,imsparsh/beets,krig/beets,beetbox/beets,pkess/beets,sadatay/beets,PierreRust/beets,kareemallen/beets,krig/beets