document menu voters
update menu doc
fix xml config doc
adjustments
fix typo
adjust doc to changes, add info about cmf_request_aware
Merge pull request #134 from symfony-cmf/menu-voters

document menu voters