Documentation improvements.

- More consistency between transmission and joint limits interfaces doc.

- Make explicit that these interfaces are not meant to be used by controllers,
  but by the robot abstraction.
Merge branch 'master' of https://github.com/willowgarage/ros_control