doc: improves the share-safe documentation
The associated behavior is now clearer and we point to the other configuration
that control the mismatching behavior.
Differential Revision: https://phab.mercurial-scm.org/D9839
#require docutils gettext $ $TESTDIR/check-gendoc da checking for parse errors