Patchwork [2,of,4] help: refactor version/defaults from format section

login
register
mail settings
Submitter timeless@mozdev.org
Date Dec. 30, 2015, 10:42 p.m.
Message ID <deb670426bd8541bd9f0.1451515344@waste.org>
Download mbox | patch
Permalink /patch/12424/
State Accepted
Headers show

Comments

timeless@mozdev.org - Dec. 30, 2015, 10:42 p.m.
# HG changeset patch
# User timeless <timeless@mozdev.org>
# Date 1451495048 0
#      Wed Dec 30 17:04:08 2015 +0000
# Node ID deb670426bd8541bd9f0ea88204a428933bae05e
# Parent  9860dd648f0aaf9fd29357657480c3d027e249b2
help: refactor version/defaults from format section

The old messages implied that disabling a single setting would ensure
compatibility, but if you disabled one of the older flags, and
left a newer flag, that would not actually do what the docs say.

Patch

diff --git a/mercurial/help/config.txt b/mercurial/help/config.txt
--- a/mercurial/help/config.txt
+++ b/mercurial/help/config.txt
@@ -670,33 +670,41 @@ 
     Enable or disable the "generaldelta" repository format which improves
     repository compression by allowing "revlog" to store delta against arbitrary
     revision instead of the previous stored one. This provides significant
-    improvement for repositories with branches. Enabled by default. Disabling
-    this option ensures that the on-disk format of newly created repository will
-    be compatible with Mercurial before version 1.9.
+    improvement for repositories with branches.
+
+    Repositories with this on-disk format require Mercurial version 1.9.
+
+    Enabled by default.
 
 ``dotencode``
     Enable or disable the "dotencode" repository format which enhances
     the "fncache" repository format (which has to be enabled to use
     dotencode) to avoid issues with filenames starting with ._ on
-    Mac OS X and spaces on Windows. Enabled by default. Disabling this
-    option ensures that the on-disk format of newly created
-    repositories will be compatible with Mercurial before version 1.7.
+    Mac OS X and spaces on Windows.
+
+    Repositories with this on-disk format require Mercurial version 1.7.
+
+    Enabled by default.
 
 ``usefncache``
     Enable or disable the "fncache" repository format which enhances
     the "store" repository format (which has to be enabled to use
     fncache) to allow longer filenames and avoids using Windows
-    reserved names, e.g. "nul". Enabled by default. Disabling this
-    option ensures that the on-disk format of newly created
-    repositories will be compatible with Mercurial before version 1.1.
+    reserved names, e.g. "nul".
+
+    Repositories with this on-disk format require Mercurial version 1.1.
+
+    Enabled by default.
 
 ``usestore``
     Enable or disable the "store" repository format which improves
     compatibility with systems that fold case or otherwise mangle
-    filenames. Enabled by default. Disabling this option will allow
-    you to store longer filenames in some situations at the expense of
-    compatibility and ensures that the on-disk format of newly created
-    repositories will be compatible with Mercurial before version 0.9.4.
+    filenames. Disabling this option will allow you to store longer filenames
+    in some situations at the expense of compatibility.
+
+    Repositories with this on-disk format require Mercurial version 0.9.4.
+
+    Enabled by default.
 
 ``graph``
 ---------