make MoveArm*() return the new position

*make MoveArmUp() and MoveArmDown() return the new position
**change teliop to use this
*other minor ArmLibrary changes
**add lightweight comment documentation for the MoveArm*() methods
**add a bit of in-method documentation explaining reasons for certain
behaviour