[media] DocBook/media_api: Better organize the DocBook

All chapters/parts but Remote controllers have the revision
tags inside the body. Move those to remote_controllers.xml and
do some cleanup.

No functional changes.

Signed-off-by: Mauro Carvalho Chehab <m.chehab@samsung.com>