subversion-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
Subject svn commit: r1807188 - /subversion/branches/better-pristines/BRANCH-README
Date Mon, 04 Sep 2017 01:48:06 GMT
Author: brane
Date: Mon Sep  4 01:48:06 2017
New Revision: 1807188

On the better-pristines branch: Add branch documentation.

* BRANCH-README: New file.

    subversion/branches/better-pristines/BRANCH-README   (with props)

Added: subversion/branches/better-pristines/BRANCH-README
--- subversion/branches/better-pristines/BRANCH-README (added)
+++ subversion/branches/better-pristines/BRANCH-README Mon Sep  4 01:48:06 2017
@@ -0,0 +1,63 @@
+This branch (^/subversion/branches/better-pristines) will be used to
+implement two dependent features:
+Client support for multiple working copy versions
+Currently the working copy code can use exactly one WC version at a
+time. This limitation is a problem for users who, for one reason or
+another, have to use multiple client versions at the same time. The
+fact that 1.8.x and 1.9.x use the same WC version was a boon to such
+users, and there's no good reason that the WC implementation couldn't
+have some leeway.
+To this end, we'll introduce the concept of "supported version" to the
+working copy. This is the minimum WC format supported by a particular
+client. By default, the client will create new working copies with the
+latest format[*], but will support a small range of older versions as
+The client should be able to not only use but also create working
+copies in an older, non-current format. To this end, certain client
+commands will get a new option, "--compatible-version", which behaves
+analogously to the option in "svnadmin create".
+For example:
+    svn checkout --compatible-version=1.8
+will create a new working copy with format 31. However,
+    svn checkout --compatible-version=1.7
+will fail, because we (currently) do not support 1.7 working copies in
+newer clients.
+    svn upgrade --compatible-version=1.9
+will upgrade an older working copy to format 31.
+The "svn --version" command will display a list of compatible working
+copy versions.
+OPTIONAL: The "svn upgrade" command may grow an option to only show
+          the current and target working copy versions.
+[*] New externals working copies must inherit the format from their
+   parent working copy, because mixed-format working copies are a) a
+   Bad Thing, and b) defeat the purpose of this feature, which is
+   support for multiple versions of the client in the same working
+   copy.
+Compressed pristines and in-database pristine storage
+WC format 32 will get support for storing (small) pristine files
+directly in the WC-DB as blobs in the PRISTINES table, and also for
+compressing pristines with LZ4.
+The current WC format 31 will remain fully supported.

Propchange: subversion/branches/better-pristines/BRANCH-README
    svn:eol-style = native

View raw message