(Some Javadoc improvements regarding sharedVariables)