Further join() docblock improvements
Further join() docblock improvements

Add example for array usage, simplify docblocks, fix yoda
conditions and typos

CakeDC/cakephp,cakephp/cakephp,timhoeppner/cakephp,eryw/cakephp,petteyg/cakephp,garethellis36/cakephp,CakeDC/cakephp,cakephp-fr/cakephp,justinyost/cakephp,jerems02/cakephp,eboominathan/cakephp,adopico/cakephp,erikfig/cakephp,davidyell/cakephp,CVO-Technologies/cakephp,dakota/cakephp,justinyost/cakephp,ADmad/cakephp,jeffblack360/cakephp,Phillaf/cakephp,tenkoma/cakephp,CVO-Technologies/cakephp,adopico/cakephp,akintoey/cakephp,garethellis36/cakephp,michaelze/cakephp,michaelze/cakephp,tgr0ss/cakephp,dakota/cakephp,davidyell/cakephp,dkarvounaris/cakephp,CakeDC/cakephp,HavokInspiration/cakephp,kumamidori/cakephp,yinhe007/cakephp,jeffblack360/cakephp,garethellis36/cakephp,burriko/cakephp,ndm2/cakephp,mvdriel/cakephp,ADmad/cakephp,tgr0ss/cakephp,jerems02/cakephp,ndm2/cakephp,cakephp-fr/cakephp,cakephp/cakephp,thinkingmedia/cakephp,akintoey/cakephp,timhoeppner/cakephp,Phillaf/cakephp,khoimt/cakephp-study,ndm2/cakephp,garethellis36/cakephp,tisu2tisu/cakephp,pbaire/cakephp,pbaire/cakephp,thinkingmedia/cakephp,petteyg/cakephp,thinkingmedia/cakephp,jeffblack360/cakephp,HavokInspiration/cakephp,Balachan27/cakephp,yinhe007/cakephp,ADmad/cakephp,michaelze/cakephp,ADmad/cakephp,khoimt/cakephp-study,jerems02/cakephp,nrother/cakephp,mvdriel/cakephp,web-player/cakephp,jjj117/cakephp,cakephp/cakephp,gmponos/cakephp,elboletaire/cakephp,tisu2tisu/cakephp,ionas/cakephp,akintoey/cakephp,bravo-kernel/cakephp,yinhe007/cakephp,dakota/cakephp,Phillaf/cakephp,cakephp/cakephp,Balachan27/cakephp,gmponos/cakephp,CakeDC/cakephp,dakota/cakephp,khoimt/cakephp-study,erikfig/cakephp,eboominathan/cakephp,elboletaire/cakephp,eboominathan/cakephp,elboletaire/cakephp,timhoeppner/cakephp,berrygoudswaard/cakephp,eryw/cakephp,erikfig/cakephp,berrygoudswaard/cakephp,dkarvounaris/cakephp,ionas/cakephp,ionas/cakephp,bravo-kernel/cakephp,nrother/cakephp,petteyg/cakephp,tgr0ss/cakephp,berrygoudswaard/cakephp,HavokInspiration/cakephp,ndm2/cakephp,dkarvounaris/cakephp,eryw/cakephp,tisu2tisu/cakephp,web-player/cakephp,CVO-Technologies/cakephp,gmponos/cakephp,nrother/cakephp,adopico/cakephp,jjj117/cakephp,tenkoma/cakephp,burriko/cakephp,Balachan27/cakephp,tenkoma/cakephp,web-player/cakephp,davidyell/cakephp,tenkoma/cakephp,bravo-kernel/cakephp,mvdriel/cakephp,kumamidori/cakephp,pbaire/cakephp,petteyg/cakephp,mvdriel/cakephp,kumamidori/cakephp,cakephp-fr/cakephp,justinyost/cakephp,jjj117/cakephp,burriko/cakephp