Note about pkg versions and building collections
authorjustin <justin@web>
Fri, 23 Nov 2018 04:15:01 +0000 (04:15 +0000)
committerIkiWiki <ikiwiki.info>
Fri, 23 Nov 2018 04:15:01 +0000 (04:15 +0000)
docs/developer/Release/index.mdwn

index 75c6820..93fa3dc 100644 (file)
@@ -85,6 +85,14 @@ Update OSNAME for mdocml:
 
 Before you tag, make sure there aren't any last minute surprises - build this new branch, current version, whatever.
 
+Note that pushing these new tags changes the searched ABI for pkg.  For a minor number change, this usually means the new release tag points at the packages used for DragonFly-current - they are usually tagged with the next version.  It also means that the new DragonFly-current doesn't have a matching path until you build it.
+
+For example: When 5.2 was the release, -current pointed at an ABI of 5.4 by default, and that's where packages were stored.  Tag 5.4 and DragonFly-current, and 5.4 exists, but 5.6, where -current will point, does not.
+
+The solution is to build on the new version ASAP.  
+
+Major version number changes leave everything without packages until new ones are build on the new major version number.  It's probably possible to simulate corrected version numbers on a -current system, but I don't know it at the time of typing this.    
+
 ##Tagging
 
 Make sure all changes on the master branch **and** on the new branch have been committed and pushed before tagging anything.