subversion-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
Subject svn commit: r1823606 - /subversion/trunk/tools/dist/README.backport
Date Thu, 08 Feb 2018 22:47:32 GMT
Author: danielsh
Date: Thu Feb  8 22:47:32 2018
New Revision: 1823606

* tools/dist/README.backport: Write down oral traditions.


Modified: subversion/trunk/tools/dist/README.backport
--- subversion/trunk/tools/dist/README.backport (original)
+++ subversion/trunk/tools/dist/README.backport Thu Feb  8 22:47:32 2018
@@ -7,20 +7,23 @@ F1. Auto-merge bot; the nightly svn-role
 F2. Conflicts detector bot; the svn-backport-conflicts-1.9.x buildbot task.
-And two interactive functions, described later.
+And two interactive functions¹:
+F3. Reviewing STATUS nominations and casting votes.
+F4. Adding new entries to STATUS.
 The scripts are:
-    oldest script, implements both [F1] and [F2], plus two interactive
-    functions¹.  As of March 2015, used in production by svn-role and
-    by svn-backport-conflicts-1.9.x.
+    oldest script, implements [F1], [F2], and [F3].  As of Feb 2018, used in
+    production by svn-role (running on svn-qavm3) and by svn-backport-conflicts-1.9.x
+    (a buildbot job).
-    Symlink to  Implements one of the two interactive features.
-    Not used by bots.
+    Symlink to  Implements [F4].  (The script inspects its argv[0].)
     Regression tests for
@@ -39,9 +42,11 @@ backport/*.py:
     Implementation of [F2] using
+    Not currently used in production.
     Implementation of [F1] using
+    Not currently used in production.
     Regression tests for and
@@ -52,13 +57,25 @@
     svntest framework (../../subversion/tests/cmdline/svntest/), which is
     written in Python 2.
+    Note that and backport/*.py are written in different
+    languages, so they never 'import' each other. invokes
+,, and
+ in the same manner: through subprocess.check_call().
     Expected output files for; see the BackportTest
-    decorator.
+    decorator in
 All scripts can be run with '--help' to display their usage messages. is considered deprecated since is better architected
+and is written in a language that many more active developers are comfortable
+with.  The unattended jobs [F1] and [F2] should be converted to using whenever someone gets around to do the legwork.  The interactive
+versions [F3] and [F4] are still in active use, however, so the physical script should be kept around until Python versions of these are
 ¹ For's interactive features, see:

View raw message