clarified some docs (closes #332)
clarified some docs (closes #332)

naderman/Silex,GromNaN/Silex,jdreesen/Silex,fabpot/Silex,romainneutron/Silex,stof/Silex,GromNaN/Silex,akucherevskiy/developex_test,JPry/Silex,cgsmith/Silex,jdreesen/Silex,Tobion/Silex,JPry/Silex,peterkokot/Silex,RayRutjes/Silex,arduanov/Silex,lokhman/Silex,RayRutjes/Silex,peterkokot/Silex,romainneutron/Silex,akucherevskiy/developex_test,stof/Silex,stof/Silex,mathroc/Silex,naderman/Silex,plotek/Silex,plotek/Silex,lyrixx/Silex,beealone/Silex,beealone/Silex,mTorres/Silex,cesarmarinhorj/Silex,silexphp/Silex,akucherevskiy/developex_test,Incognito/silex-fork,SanderKnape/Silex,naderman/Silex,lokhman/Silex,mathroc/Silex,cesarmarinhorj/Silex,fhinkel/Silex,CarsonF/Silex,cgsmith/Silex,SpacePossum/Silex,mmauri04/Silex,fhinkel/Silex,gencer/Silex,SpacePossum/Silex,SanderKnape/Silex,tcx1000/Silex,lyrixx/Silex,mmauri04/Silex,arduanov/Silex,CarsonF/Silex,fabpot/Silex,mTorres/Silex,romainneutron/Silex,peterkokot/Silex,Tobion/Silex,Incognito/silex-fork,Xephi/Silex,GromNaN/Silex,CarsonF/Silex,Tobion/Silex,tcx1000/Silex,lyrixx/Silex,Xephi/Silex