share: add documentation about various configs introduced recently

My recent series added these 4 configs which control how to behave when there is
difference in share-safe state of source and shares. However my patches were
missing documentation. This patch adds it.

The documentation is added in verbose part as the feature and config are
experimental.
13 jobs for topic/default/share-safe-better in 21 minutes and 54 seconds (queued for 2 seconds)
Status Name Job ID Coverage
  Tests
passed checks-py2 #151331

00:05:34

passed checks-py3 #151332

00:03:55

passed rust-cargo-test-py2 #151333

00:02:41

passed rust-cargo-test-py3 #151334

00:02:40

failed test-py2 #151335

00:20:56

failed test-py2-chg #151341

00:21:07

failed test-py2-pure #151337

00:20:23

failed test-py2-rust #151339

00:21:52

failed test-py3 #151336

00:12:58

failed test-py3-chg #151342

00:06:47

failed test-py3-pure #151338

00:12:37

failed test-py3-rust #151340

00:09:45

 
  Phabricator
skipped phabricator-refresh #151343
 
Name Stage Failure
failed
test-py3-chg Tests
Skipped test-verify-repo-operations.py: missing feature: allow slow tests (use --allow-slow-tests)
Skipped test-wireproto-command-capabilities.t: system supports running with chg
Skipped test-wireproto-exchangev2-shallow.t: missing feature: sqlite3 module is available
Failed test-commit-interactive.t: output changed
Failed test-i18n.t: output changed
Failed test-log.t: output changed
# Ran 848 tests, 98 skipped, 3 failed.
python hash seed: 236478314
ERROR: Job failed: exit code 1
failed
test-py2-chg Tests
Skipped test-wireproto-exchangev2-shallow.t: missing feature: sqlite3 module is available
Failed test-commit-interactive.t: output changed
Failed test-i18n.t: output changed
Failed test-log.t: output changed
# Ran 853 tests, 93 skipped, 3 failed.
python hash seed: 1391107493
Running after_script
Uploading artifacts for failed job
ERROR: Job failed: exit code 1
failed
test-py3-rust Tests
Skipped test-wireproto-exchangev2-shallow.t: missing feature: sqlite3 module is available
Failed test-commit-interactive.t: output changed
Failed test-i18n.t: output changed
Failed test-log.t: output changed
# Ran 868 tests, 78 skipped, 3 failed.
python hash seed: 1095886941
Running after_script
Uploading artifacts for failed job
ERROR: Job failed: exit code 1
failed
test-py2-rust Tests
Failed test-commit-interactive.t: output changed
Failed test-i18n.t: output changed
Failed test-log.t: output changed
Failed test-persistent-nodemap.t: output changed
# Ran 873 tests, 73 skipped, 4 failed.
python hash seed: 1170693043
Running after_script
Uploading artifacts for failed job
ERROR: Job failed: exit code 1
failed
test-py3-pure Tests
Skipped test-wireproto-exchangev2-shallow.t: missing feature: sqlite3 module is available
Failed test-commit-interactive.t: output changed
Failed test-i18n.t: output changed
Failed test-log.t: output changed
# Ran 865 tests, 81 skipped, 3 failed.
python hash seed: 1272227685
Running after_script
Uploading artifacts for failed job
ERROR: Job failed: exit code 1
failed
test-py2-pure Tests
Failed test-commit-interactive.t: output changed
Failed test-i18n.t: output changed
Failed test-log.t: output changed
Failed test-persistent-nodemap.t: output changed
# Ran 870 tests, 76 skipped, 4 failed.
python hash seed: 1217433731
Running after_script
Uploading artifacts for failed job
ERROR: Job failed: exit code 1
failed
test-py3 Tests
Failed test-commit-interactive.t: output changed
Failed test-i18n.t: output changed
Failed test-log.t: output changed
Failed test-remotefilelog-local.t: output changed
# Ran 868 tests, 78 skipped, 4 failed.
python hash seed: 1112042118
Running after_script
Uploading artifacts for failed job
ERROR: Job failed: exit code 1
failed
test-py2 Tests
Skipped test-wireproto-exchangev2-shallow.t: missing feature: sqlite3 module is available
Failed test-commit-interactive.t: output changed
Failed test-i18n.t: output changed
Failed test-log.t: output changed
# Ran 873 tests, 73 skipped, 3 failed.
python hash seed: 3677103079
Running after_script
Uploading artifacts for failed job
ERROR: Job failed: exit code 1