Bump opam-root-version to 2.2 (#5980)

* reftest: fix and harmonise opam root version test

* update release instructions

* Bump opam-root-version to 2.2

---------

Co-authored-by: Raja Boujbel <raja.boujbel@ocamlpro.com>

Author: kit-ty-kate

master_changes.md

@@ -12,6 +12,7 @@ users)
 
 ## Version
   * Bump version to 2.3.0~alpha~dev [#6045 @rjbou]
+  * Bump opam-root-version to 2.2 [#5980 @kit-ty-kate]
 
 ## Global CLI
   * Add cli version 2.3 [#6045 @rjbou]

release/readme.md

@@ -1,9 +1,10 @@
 # Steps to follow for each release
 
 ## Finalise opam code for release
-* update version in opam files, configure.ac
+* update version in all the opam files and in configure.ac
 * run `make configure` to regenerate `./configure` [checked by github actions]
 * update copyright headers
+* if you're releasing the first final release of a new branch (e.g. 2.2.0): make sure `root_version` in OpamFile.ml is set to the final release number (e.g. for 2.2.0, root_version should be 2.2). Make sure that opamFormatUpgrade.ml also contains an upgrade function from the previous version (that function will most likely be empty)
 * run `make tests`, `opam-rt` [checked by github actions]
 * update the CHANGE file: take `master_changes.md` content to fill it
 

src/format/opamFile.ml

@@ -1395,7 +1395,7 @@ module ConfigSyntax = struct
   let atomic = false
   let format_version = OpamVersion.of_string "2.1"
   let file_format_version = OpamVersion.of_string "2.0"
-  let root_version = OpamVersion.of_string "2.2~beta"
+  let root_version = OpamVersion.of_string "2.2"
 
   let default_old_root_version = OpamVersion.of_string "2.1~~previous"
 

src/state/opamFormatUpgrade.ml

@@ -1143,6 +1143,10 @@ let from_2_2_alpha_to_2_2_beta ~on_the_fly _ conf =
    | None -> info_jobs_changed ~prev_jobs:1);
   OpamFile.Config.with_jobs_opt None conf, gtc_none
 
+let v2_2 = OpamVersion.of_string "2.2"
+
+let from_2_2_beta_to_2_2 ~on_the_fly:_ _ conf = conf, gtc_none
+
 (* To add an upgrade layer
    * If it is a light upgrade, returns as second element if the repo or switch
      need an light upgrade with `gtc_*` values.
@@ -1239,6 +1243,7 @@ let as_necessary ?reinit requested_lock global_lock root config =
      ]) @ [
       v2_2_alpha,  from_2_1_to_2_2_alpha;
       v2_2_beta,   from_2_2_alpha_to_2_2_beta;
+      v2_2,        from_2_2_beta_to_2_2;
     ]
     |> List.filter (fun (v,_) ->
         OpamVersion.compare root_version v < 0)