JERSEY-1868: documentation "wadl" section.

- PS2: rebased + latest version of jersey.ent used.
- PS3: incorporated review comments.

Change-Id: Ic978c1b49e77279cb3060eeec3174777d28709e4
Signed-off-by: Marek Potociar <marek.potociar@oracle.com>