JERSEY-2379: Initial commit of 'Selectable' filtering implementation.

 - minor cosmetic changes + changes in docs

Change-Id: I3d3c031287a020cdfd0d73f85e9492bf5a0b51a1
Signed-off-by: Michal Gajdos <michal.gajdos@oracle.com>