changeset 5195:85640f1feced

readme: mention compat string format
author Anton Shestakov <av6@dwimlabs.net>
date Wed, 11 Mar 2020 16:11:04 +0700
parents f478ac0a818f
children 034d6d0efa7d
files README
diffstat 1 files changed, 10 insertions(+), 0 deletions(-) [+]
line wrap: on
line diff
--- a/README	Wed Mar 11 15:55:36 2020 +0700
+++ b/README	Wed Mar 11 16:11:04 2020 +0700
@@ -139,6 +139,16 @@
     $ cd tests
     $ python $HGSRC/tests/run-tests.py
 
+When certain blocks of code need to cope with API changes in core Mercurial,
+they should have comments in the ``hg <= x.y (commit hash)`` format. For
+example, if a function needs another code path because of changes introduced in
+02802fa87b74 that was first included in Mercurial 5.3, then the comment should
+be::
+
+    # hg <= 5.2 (02802fa87b74)
+
+See also tests/test-check-compat-strings.t.
+
 Branch policy
 -------------