clean + correct docs and comments
clean + correct docs and comments
remove last deep globals ref