[SVN-4887] multi-wc-format: clarify/unify option names for compatible-version

• Type: Improvement
• Status: Open
• Priority: Major
• Resolution: Unresolved
• Fix Version/s: 1.15-proposed
• Labels: api
• Assignee: Unassigned
• Reporter: Julian Foad
• Created: 24/Feb/22 12:56
• Updated: 23/Mar/22 09:45

Description

Clarify/unify the option names used for specifying the WC format compatible version.

Subversion commands also have other compatibility concerns besides the WC format. (repo format, for one.)

Current option names:

• --compatible-version # for 'svnadmin': repository version
• --compatible-version # for 'svn': WC version
• --wc-format-version # for the tests: WC version

Suggestions for WC version everywhere ('svn' and tests):

• --wc-compatible-version
• --wc-compatible-format

Consider also the 'svn info --show-item' label(s):

• --show-item=wc-format
• --show-item=wc-compatible-version

Consider also the list of WC formats shown in 'svn --version', currently:

Supported working copy (WC) formats:
* compatible with Subversion v1.8 to v1.15 (WC format 31)
* compatible with Subversion v1.15 (WC format 32)

This could usefully show the exact command option syntax to use, e.g.

* --wc-compatible-version=1.8 (up to v1.15) (WC format 31)
* --wc-compatible-version=1.15 (WC format 32)

Issue Links

• blocks: SVN-4886 multi-wc-format: config for default WC version for checkout & upgrade
• blocks: SVN-4883 multi-wc-format