Update doc to reflect the actual behavior of remove_router_interface

Fixes bug 1174481

Change-Id: I889880bd66e14987fbb1f8acd919399b04936e0b
Merge "Update doc to reflect the actual behavior of remove_router_interface"