Everything that you've mentioned is the reason behind berrybrew. It does all of that path documenting and management itself. It provides you the ability to switch between versions with a single command (or in newer versions, with a couple of clicks of the mouse as well).