Changes between Version 13 and Version 14 of venice/bsp

Timestamp:

12/09/2021 05:51:48 PM (3 years ago)

Author:

Tim Harvey

Comment:

added additional info about repo tool

venice/bsp

@@ -92 +92 @@
 
 
+[=#repo]
+=== Working with the repo tool
+
+==== Updating to the latest code
+When working with the {{{repo}}} tool you can update to the latest code using the {{{repo sync}}} command:
+{{{#!bash
+$ repo sync
+Fetching: 100% (8/8), done in 5.258s
+Garbage collecting: 100% (8/8), done in 0.188s
+repo sync has finished successfully.
+}}}
+
+The {{{repo}}} tool works off of a manifest file in {{{.repo/manifests/default.xml}}} which specifies the various projects, what repo they are in, and where they are checked out in your directory structure. If a branch has changed, a project added, or a project removed the manifest file will be updated when you run {{{repo sync}}} then it will update the various project repos. If a branch has changed to something new you can encounter an error such as:
+{{{#!bash
+$ repo sync
+remote: Enumerating objects: 5, done.
+remote: Counting objects: 100% (5/5), done.
+remote: Compressing objects: 100% (1/1), done.
+remote: Total 3 (delta 1), reused 3 (delta 1), pack-reused 0
+Unpacking objects: 100% (3/3), done.
+project .repo/manifests/
+Updating 5c981dac1797..0b0055e7445e
+Fast-forward
+
+error: in `sync`: revision v5.10.76-venice in Gateworks/linux-venice not found
+}}}
+
+This specific error is saying that the 'v5.10.76-venice' revision (or branch) is not in the current working copy of the repo. To resolve this you need to do a {{{git remote update}}} for that project:
+{{{#!bash
+git -C linux remote update
+}}} 
+
+
+==== Using the latest version
+The {{{repo}}} tool is updated frequently. While it is rarely necessary to have the latest version it will inform you if there is an update and how to install that update in the current working directory:
+{{{#!bash
+$ repo sync
+
+... A new version of repo (2.17) is available.
+... You should upgrade soon:
+    cp /usr/src/venice/bsp/.repo/repo/repo /home/user/bin/repo
+...
+}}}
+
+To update the {{{repo}}} tool just copy the file as mentioned above:
+{{{#!bash
+cp .repo/repo/repo $HOME/bin/repo
+}}}
+
+
 [=#kernel]
 === Modifying the stand-alone Linux Kernel