summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorNirbheek Chauhan <nirbheek@centricular.com>2021-04-09 11:38:27 +0530
committerNirbheek Chauhan <nirbheek@centricular.com>2021-04-12 08:20:41 +0530
commit2ebc27b5e9084e5cc4b1fff1b04a0f8c6c6664ec (patch)
treef46513518b457a5c07ba35686d23b1e0ba3f072f
parent54e1dbd6138d71d3291f132005fcca06ab66a753 (diff)
installing: Document how to build gstreamer releases with cerbero
Part-of: <https://gitlab.freedesktop.org/gstreamer/gst-docs/-/merge_requests/151>
-rw-r--r--markdown/installing/building-from-source-using-cerbero.md15
1 files changed, 15 insertions, 0 deletions
diff --git a/markdown/installing/building-from-source-using-cerbero.md b/markdown/installing/building-from-source-using-cerbero.md
index 5306440..5c1e3de 100644
--- a/markdown/installing/building-from-source-using-cerbero.md
+++ b/markdown/installing/building-from-source-using-cerbero.md
@@ -61,11 +61,26 @@ To build GStreamer using Cerbero, you first need to download **Cerbero**:
$ git clone https://gitlab.freedesktop.org/gstreamer/cerbero
```
+This will build the latest unreleased GStreamer code.
+
Despite the presence of `setup.py` this tool does not need installation. It is
invoked via the `cerbero-uninstalled` script, which should be invoked as
`./cerbero-uninstalled`, or you can create an alias to it in your `.bashrc`
file.
+You can build a specific release by checking out that tag, for example `git
+checkout 1.18.4`. Building a release tag will cause Cerbero to use the release
+tarballs instead of git repositories when fetching gstreamer recipes for
+building.
+
+You can also build the latest unreleased 'stable branch' code, for instance for
+1.18 you'd do: `git checkout 1.18`, or `git clone -b 1.18 [...]`, which will
+fetch the corresponding stable branches when building gstreamer recipes.
+
+You can also use git worktrees, which may be more convenient when building
+several different versions of gstreamer since the build artefacts always go
+into the `build` directory inside the git repository.
+
## Bootstrap to setup environment
Before using cerbero for the first time, you will need to run the bootstrap