add clarifications in README in submodule; synch submodule