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

index 3f156f7..113deba 100644 (file)
@@ -22,11 +22,62 @@ For more information on how to build Chromium from source for other platforms se
 
 The list of third-party software is a long one, you can check it [[here|https://cs.chromium.org/chromium/src/third_party/]].
 
-## Appendix
+## Current update procedure
 
-### Tools
+This is how we are performing the Chromium updates right now, contributions/ideas are very welcome :-)
+
+### Repository location and contributions
+
+The "DragonFly Chromium" repository is located in server **crater**, where all the source repositories are located. There is also a clone of them in server **leaf**. You can access the [[dragonfly's gitweb page|https://gitweb.dragonflybsd.org/]] to browse the code without the need of cloning it. The repository is called _chromium-dfly.git_.
+
+We recommend cloning from crater just in case the mirroring on leaf fails for some reason:
+
+    # git clone git://crater.dragonflybsd.org/chromium-dfly.git
+    Cloning into 'chromium-dfly'...
+    remote: Counting objects: 469609, done.
+    remote: Compressing objects: 100% (254827/254827), done.
+    [....]
+
+Only DragonFly committers can push to this repository in crater, you can specify a different url for pushing so that the SSH keys is only used for _git-push_, see below an example of _.git/config_:
+
+    [remote "crater"]                                                                                                    
+            url = git://crater.dragonflybsd.org/chromium-dfly.git
+            pushurl = ssh://crater.dragonflybsd.org/repository/git/chromium-dfly.git
+            fetch = +refs/heads/*:refs/remotes/crater/*
+
+Anyone can submit patches, just go to [[our bug tracker and send an issue for the tracker "Submit"|https://bugs.dragonflybsd.org/projects/dragonfly/issues/new]].
+
+### Repository layout
+
+Vanilla Chromium versions are imported from tarballs to branches named like "chromium-<exact-version>", see below the current ones:
 
-The Chromium project offers a cross-reference tool which is extremely useful when working on Chromium source code: [[Chromium Search Code|https://cs.chromium.org/]]
 
+    # git branch -a | fgrep crater/chromium
+      remotes/crater/chromium-60.0.3112.113
+      remotes/crater/chromium-60.0.3112.116
+      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:
 
+
+    # 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".
+
+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:
+
+
+    # git branch -a | grep dfly |grep crater
+      remotes/crater/60-dfly
+      remotes/crater/67-dfly
+      remotes/crater/67.bad-dfly
+
+
+## Appendix
+
+### Tools
+
+The Chromium project offers a cross-reference tool which is extremely useful when working on Chromium source code: [[Chromium Search Code|https://cs.chromium.org/]]