From 87836bf73885f6811f44459981f56484426d566b Mon Sep 17 00:00:00 2001
From: Bradley Sepos <bradley@bradleysepos.com>
Date: Sun, 26 Dec 2021 13:03:47 -0500
Subject: [PATCH] Add tag checkout info to 1.4.0 build guides.

---
 source/docs/en/1.4.0/developer/build-bsd.markdown     | 5 +++++
 source/docs/en/1.4.0/developer/build-linux.markdown   | 5 +++++
 source/docs/en/1.4.0/developer/build-mac.markdown     | 5 +++++
 source/docs/en/1.4.0/developer/build-windows.markdown | 7 ++++++-
 4 files changed, 21 insertions(+), 1 deletion(-)

diff --git a/source/docs/en/1.4.0/developer/build-bsd.markdown b/source/docs/en/1.4.0/developer/build-bsd.markdown
index a1b1fc5b..6adf165e 100644
--- a/source/docs/en/1.4.0/developer/build-bsd.markdown
+++ b/source/docs/en/1.4.0/developer/build-bsd.markdown
@@ -31,6 +31,11 @@ Clone the HandBrake repository.
 
     git clone https://github.com/HandBrake/HandBrake.git && cd HandBrake
 
+List available tags in the HandBrake 1.4.x release series, and check out the most recent.
+
+    git tag --list | grep ^1\.4\.
+    git checkout refs/tags/$(git tag -l | grep -E '^1\.4\.[0-9]+$' | tail -n 1)
+
 Build HandBrake. To enable experimental support for Intel Quick Sync Video, append `--enable-qsv`. To build the command line interface only, disable the graphical interface by appending `--disable-gtk`.
 
     ./configure --launch-jobs=$(sysctl -n hw.ncpu) --launch
diff --git a/source/docs/en/1.4.0/developer/build-linux.markdown b/source/docs/en/1.4.0/developer/build-linux.markdown
index 7bbdecfc..ca89e6f1 100644
--- a/source/docs/en/1.4.0/developer/build-linux.markdown
+++ b/source/docs/en/1.4.0/developer/build-linux.markdown
@@ -39,6 +39,11 @@ Clone the HandBrake repository.
 
     git clone https://github.com/HandBrake/HandBrake.git && cd HandBrake
 
+List available tags in the HandBrake 1.4.x release series, and check out the most recent.
+
+    git tag --list | grep ^1\.4\.
+    git checkout refs/tags/$(git tag -l | grep -E '^1\.4\.[0-9]+$' | tail -n 1)
+
 Build HandBrake. To enable experimental support for Intel Quick Sync Video, append `--enable-qsv`. To build the command line interface only, disable the graphical interface by appending `--disable-gtk`.
 
     ./configure --launch-jobs=$(nproc) --launch
diff --git a/source/docs/en/1.4.0/developer/build-mac.markdown b/source/docs/en/1.4.0/developer/build-mac.markdown
index 1c54c6c1..036efaea 100644
--- a/source/docs/en/1.4.0/developer/build-mac.markdown
+++ b/source/docs/en/1.4.0/developer/build-mac.markdown
@@ -53,6 +53,11 @@ Clone the HandBrake repository.
 
     git clone https://github.com/HandBrake/HandBrake.git && cd HandBrake
 
+List available tags in the HandBrake 1.4.x release series, and check out the most recent.
+
+    git tag --list | grep ^1\.4\.
+    git checkout refs/tags/$(git tag -l | grep -E '^1\.4\.[0-9]+$' | tail -n 1)
+
 Initialize and update all submodules.
 
     git submodule update --init --recursive
diff --git a/source/docs/en/1.4.0/developer/build-windows.markdown b/source/docs/en/1.4.0/developer/build-windows.markdown
index 941dc7b7..c7adffb7 100644
--- a/source/docs/en/1.4.0/developer/build-windows.markdown
+++ b/source/docs/en/1.4.0/developer/build-windows.markdown
@@ -77,6 +77,11 @@ Clone the HandBrake repository.
 
     git clone https://github.com/HandBrake/HandBrake.git && cd HandBrake
 
+List available tags in the HandBrake 1.4.x release series, and check out the most recent.
+
+    git tag --list | grep ^1\.4\.
+    git checkout refs/tags/$(git tag -l | grep -E '^1\.4\.[0-9]+$' | tail -n 1)
+
 Build the MinGW-w64 toolchain using the included script, where `username` is your user name. Feel free to choose a different output path, if desired.
 
     scripts/mingw-w64-build x86_64 /home/username/toolchains/
@@ -105,7 +110,7 @@ The following tools are required to build and run the [GUI](abbr:Graphical User
 - `hb.dll` (see the LibHB build instructions preceding these, or download from [https://handbrake.fr/nightly.php](https://handbrake.fr/nightly.php))
 
 
-Clone `https://github.com/HandBrake/HandBrake.git` using your git client.
+Clone `https://github.com/HandBrake/HandBrake.git` using your git client, and check out the most recent tag in the 1.4.x release series.
 
 Source code for the GUI resides in the `win\CS` folder and the solution file is named `HandBrake.sln`. Make sure HandBrakeWPF is set as the startup project in the Solution Explorer by right-clicking the name and selecting "Set as startup project".