DEB build scripts: added initial support for git worktrees.

Signed-off-by: Michele Calgaro <michele.calgaro@yahoo.it>

1 files changed, 23 insertions, 11 deletions

diff --git a/debian/_buildscripts/local/README.txt b/debian/_buildscripts/local/README.txt
index e36f5ceed..fe08e1fc1 100644
--- a/debian/_buildscripts/local/README.txt
+++ b/debian/_buildscripts/local/README.txt
@@ -33,16 +33,28 @@ A) Environment preparation
                           Mainly used to apply patches automatically during the building process
 
 4) Clone TDE git repositories
-   - TDE main repo
-     cd "$TDE_DIR/1_git"
-     git clone https://mirror.git.trinitydesktop.org/gitea/TDE/tde.git
-     git clone https://mirror.git.trinitydesktop.org/gitea/TDE/scripts.git tde/scripts
-     cd tde
-     ./scripts/switch_all_submodules_to_head_and_clean anonymous
+   A) without using git worktrees
+      A.1) Main repo:
+        cd "$TDE_DIR/1_git"
+        git clone https://mirror.git.trinitydesktop.org/gitea/TDE/tde.git
+        git clone https://mirror.git.trinitydesktop.org/gitea/TDE/scripts.git tde/scripts
+        cd tde
+        ./scripts/switch_all_submodules_to_head_and_clean anonymous
 
-   - If you are not using pre-built extra dependencies:
-     cd "$TDE_DIR/1_git"
-     git clone https://mirror.git.trinitydesktop.org/gitea/TDE/extra-dependencies.git edeps
+      A.2) If you are not using pre-built extra dependencies:
+        cd "$TDE_DIR/1_git"
+        git clone https://mirror.git.trinitydesktop.org/gitea/TDE/extra-dependencies.git edeps
+
+   B) using git worktrees
+      B.1) Main repo
+        cd "$TDE_DIR/1_git"
+        git clone --bare --config "remote.origin.fetch=+refs/heads/*:refs/remotes/origin/*" https://mirror.git.trinitydesktop.org/gitea/TDE/tde.git repos/tde.git
+
+      B.2) If you are not using pre-built extra dependencies:
+        cd "$TDE_DIR/1_git"
+        git clone --bare --config "remote.origin.fetch=+refs/heads/*:refs/remotes/origin/*" https://mirror.git.trinitydesktop.org/gitea/TDE/extra-dependencies.git repos/edeps.git
+
+      B.3) run the script "update_repositories.sh" once you have completed the setup as described later in this document.
 
 5) Add your user to the sudo group (not required if you are root)
      su -c "adduser <username> sudo"
@@ -126,14 +138,14 @@ When building sets of modules or the whole TDE, a global build summary is automa
 - scripts in 'internals' folder
   Scripts used intenally by other scripts. No need for invoking these directly.
 
-- update_git_repository.sh:
+- update_repositories.sh:
   Script used to update the local clone of the git repositories.
   It is possible to update multiple branches as specified by the variable UPDATE_BRANCHES in the configuration
   file. After the update is completed, the local repositories will be switched to the branch specified by the
   DEFAULT_REPO_BRANCH variable.
   The script can also be used to switch the local repositories to a particular branch, without performing any update.
   Usage:
-    update_git_repository.sh [options]
+    update_repositories.sh [options]
   Options:
     -i  (Incremental) : in case the previous update was interrupted, continue from the last known updated module.
                         (useful on slow/unstable internet connections). If the previous update had completed,