(no commit message)
authortuxillo <tuxillo@web>
Sun, 2 Sep 2018 18:18:25 +0000 (18:18 +0000)
committerIkiWiki <ikiwiki.info>
Sun, 2 Sep 2018 18:18:25 +0000 (18:18 +0000)
docs/howtos/HowToUpdateChromium/index.mdwn

index 113deba..5b0deea 100644 (file)
@@ -49,7 +49,7 @@ Anyone can submit patches, just go to [[our bug tracker and send an issue for th
 
 ### Repository layout
 
-Vanilla Chromium versions are imported from tarballs to branches named like "chromium-<exact-version>", see below the current ones:
+Vanilla Chromium versions are imported from tarballs to branches named like "chromium-[exact-version]", see below the current ones:
 
 
     # git branch -a | fgrep crater/chromium
@@ -58,22 +58,61 @@ Vanilla Chromium versions are imported from tarballs to branches named like "chr
       remotes/crater/chromium-67.0.3396.87
       remotes/crater/chromium-68.0.3440.106
 
-The FreeBSD branches are named like: _<major chromium version>-freebsd_  . In case there are several Chromium branches with the same major version, then the last part of the version is used, see below the current ones:
+The FreeBSD branches are named like: _[major chromium version]-freebsd_  . In case there are several Chromium branches with the same major version, then the last part of the version is used, see below the current ones:
 
 
     # git branch -a | grep freebsd |grep crater
       remotes/crater/60.113-freebsd
       remotes/crater/67-freebsd
 
-In the above the branch _"60.113-freebsd"_ is based on the vanilla chromium branch _"chromium-60.0.3112.113"_ . As for _"chromium-67.0.3396.87" there is only one chromium-67 so the FreeBSD branch is called "67-freebsd".
+In the above the branch _"60.113-freebsd"_ is based on the vanilla chromium branch _"chromium-60.0.3112.113"_ . As for _"chromium-67.0.3396.87"_ there is only one chromium-67 so the FreeBSD branch is called "67-freebsd".
 
-The DragonFly branches are named like: _<major chromium version>-freebsd_ . In case there are several Chromium branches with the same major version the same as for FreeBSD applies. For DragonFly there might be user-specific branches. See below the current ones:
+The DragonFly branches are named like: _[major chromium version]-dfly_ . In case there are several Chromium branches with the same major version the same as for FreeBSD applies. For DragonFly there might be user-specific branches. See below the current ones:
 
 
     # git branch -a | grep dfly |grep crater
       remotes/crater/60-dfly
       remotes/crater/67-dfly
-      remotes/crater/67.bad-dfly
+
+### Importing a new Chromium version
+
+Normally we would import the next Chromium version that is in FreeBSD ports. In this example we're going to use version _68.0.3440.106_. The download URL is: [[https://commondatastorage.googleapis.com/chromium-browser-official/chromium-68.0.3440.106.tar.xz|https://commondatastorage.googleapis.com/chromium-browser-official/chromium-68.0.3440.106.tar.xz]].
+
+* Create a new branch based on a previous one for the import, remove all its contents and amend the commit message:
+
+        # cd chromium-dfly
+        # git checkout -b chromium-68.0.3440.106 crater/chromium-60.0.3112.113
+        # rm -fr *
+        # rm .*
+        # git commit -a --amend --allow-empty -m 'Initial import chromium-68.0.3440.106'
+
+* Import the tarball to your newly created branch:
+
+        # tar --strip-components 1 --xzf /usr/distfiles/chromium-68.0.3440.106.tar.xz
+        # git add -f .
+        # git commit --amend -m 'Initial import chromium-68.0.3440.106'
+
+* Push the new branch to crater (if you are a DragonFly developer) and maybe prune old branches if they are older than 4 releases:
+
+        # git push crater chromium-68.0.3440.106
+
+### Create the FreeBSD branch
+
+This requires either a checkout of FreeBSD ports or at least the www/chromium directory from it. **Make sure you are working with the correct Chromium version!**
+
+    # fgrep PORTVERSION ~/s/freebsd-ports/www/chromium/Makefile
+    PORTVERSION=    68.0.3440.106
+
+Now create a branch for FreeBSD:
+
+    # cd chromium-dfly
+    # git checkout -b 68-freebsd crater/chromium-68.0.3440.106
+
+Apply all FreeBSD patches to your new branch:
+
+    # git rev-parse --abbrev-ref HEAD
+    68-freebsd
+    # sh -c 'for p in ~/s/freebsd-ports/www/chromium/patch*; do patch -p0 < $p; done'
 
 
 ## Appendix