Clarify rearrangement documentation
Clarify rearrangement documentation

(I think this is right)

glennhickey/hal,glennhickey/hal,glennhickey/hal,glennhickey/hal,glennhickey/hal,glennhickey/hal,glennhickey/hal,glennhickey/hal