Update BuildFile.xml to link against new RecoEgamma/EgammaTools lib
tidy up documentation