+ # Move the user *src* to *dst* within the Agendav database. This
+ # should "rename" him in _every_ table where he is referenced.
+ #
+ # This can fail is *src* does not exist, or if *dst* already exists
+ # before the move. It should also be an error if the destination
+ # domain doesn't exist. But Agendav doesn't know about domains, so
+ # we let that slide.
+ #
+ # @param src [User] the source user to be moved.
+ #
+ # @param dst [User] the destination user being moved to.
+ #
+ def mv_user(src, dst)
+ raise NonexistentUserError.new(src.to_s()) if not user_exists(src)
+ raise UserAlreadyExistsError.new(dst.to_s()) if user_exists(dst)