Doc: added note to explain checkout issues with submodules

Document error which can occur when switching to an older branch which
still has code from libraries in a subdirectory rather than a submodule.
Provide workaround, including also method to switch back.