Changes between Version 41 and Version 42 of newport/bsp

Timestamp:

12/09/2021 05:50:24 PM (3 years ago)

Author:

Tim Harvey

Comment:

added more info about the repo tool

newport/bsp

@@ -111 +111 @@
 
 
+[=#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 (ie for Ubuntu)