diff options
Diffstat (limited to 'debian/_buildscripts/local/scripts/README.txt')
-rw-r--r-- | debian/_buildscripts/local/scripts/README.txt | 34 |
1 files changed, 20 insertions, 14 deletions
diff --git a/debian/_buildscripts/local/scripts/README.txt b/debian/_buildscripts/local/scripts/README.txt index f409076be..244b323c3 100644 --- a/debian/_buildscripts/local/scripts/README.txt +++ b/debian/_buildscripts/local/scripts/README.txt @@ -13,19 +13,17 @@ C) How to use the scripts 1) Install pbuilder and configure it (see https://wiki.ubuntu.com/PbuilderHowto and https://wiki.debian.org/PbuilderTricks for a detailed tutorial) - You can use the file ".pbuilderrc" from following point 2) - - Create the folder "/var/cache/pbuilder/repo" - - cd into "/var/cache/pbuilder/repo" and execute "touch Packages" to create an empty file "Packages" 2) Copy files from "additional files" folder to respectivily named folder. - "user_home_folder" refers to the user home folder. - - make sure to make the files in "usr/lib/pbuilder/hooks" executable + - make sure to make the files in "user home folder/.pbuilder/hooks" executable 3) Create base package with the command: - pbuilder --create + pbuilder --create If you wish to build for a different distro, use the command: - DIST=<target distro> pbuilder --create + DIST=<target distro> pbuilder --create -4) Create a base folder for TDE, hereafter referred to as TDE_SRC (for example ~/tde_src) +4) Create a base folder for TDE, hereafter referred to as TDE_SRC (for example $HOME/tde_src) 5) Create the following folders [ see NOTE at point 0) about folder names ] - in TDE_SRC: 0_logs : contains log files for repo update and global builds (more on this later) @@ -40,14 +38,19 @@ C) How to use the scripts 6) Clone TDE git repositories and extra dependency modules: - cd "TDE_SRC/1_git" - - clone tde repo : git clone http://scm.trinitydesktop.org/scm/git/tde - - clone tde packaging repo: git clone http://scm.trinitydesktop.org/scm/git/tde-packaging - - download the source code for extra dependency modules from the official PPA: - https://quickbuild.pearsoncomputing.net/~trinity/+archive/trinity-nightly-build-dependencies/+packages - or from Slavek's PPA (usually more recently updated): + - clone tde repo : git clone https://mirror.git.trinitydesktop.org/gitea/TDE/tde + - clone tde packaging repo: git clone https://mirror.git.trinitydesktop.org/gitea/TDE/tde-packaging + - using a browser, download the source code for extra dependency modules from Slavek's PPA + (usually more recently updated): https://quickbuild.pearsoncomputing.net/~slavek-banko/+archive/deps-r14/+packages - Make sure you select the correct modules for your distribution and copy them to TDE_SRC/1_git/edeps/<MODULE NAME>. - Do not download the .deb packages, since those will be rebuilt when building TDE. + or from the official PPA: + https://quickbuild.pearsoncomputing.net/~trinity/+archive/trinity-nightly-build-dependencies/+packages + NOTES: + * Once the page open in your browser, select your distro in the combobox and click the "Filter" button. + You should get a list of 10-15 modules, depending on the distro + * Click on one module at a time, it will expand and show a list of .deb and other files below. + * Save those files (exclude .deb files. Only .orig.tar.xz, .dsc, .debian.tar.xz are required) and store + them to TDE_SRC/1_git/edeps/<MODULE NAME> folder (one folder per module) 7) Setup the build scripts locally: - copy build scripts from "TDE_SRC/1_git/tde-packaging/debian/_buildscripts/local/scripts" to "TDE_SRC/buildscripts" @@ -55,6 +58,9 @@ C) How to use the scripts - cp _build_config_template.sh build_config.sh - edit "build_config.sh" to set your preferences and check that the various folder names match the structure on your disk. +8) Add your user to the sudoers group (not required if you are root): + sudo adduser <your user> sudo + ------------------------------ @@ -65,7 +71,7 @@ Modules are built using the build_module.sh script. After the build is completed The source code can be either the git repo or a local copy in TDE_SRC/2_build/build/<MODULE NAME>. A module can be built in a clean chroot environment using pbuilder (default option) or locally using dpkg-buildpackage (useful for quick debugging/developing). -When using pbuilder, a hook can be used to invoke a shell when the build fails (see also "known issues"). +When using pbuilder, a hook can be used to invoke a shell when the build fails. Build logs are automatically stored to files, but can also be displayed during the build process. The default location of a module build log is TDE_SRC/2_build/debs/<MODULE NAME>/src/__build__.log |