summaryrefslogtreecommitdiffstats
path: root/debian/README
diff options
context:
space:
mode:
Diffstat (limited to 'debian/README')
-rw-r--r--debian/README83
1 files changed, 83 insertions, 0 deletions
diff --git a/debian/README b/debian/README
new file mode 100644
index 0000000000..01e7967e51
--- /dev/null
+++ b/debian/README
@@ -0,0 +1,83 @@
+LibreOffice build system
+------------------------
+
+Building the packages from source
+=================================
+Overview:
+ apt-get source libreoffice
+ apt-get build-dep libreoffice (to install build dependencies)
+ cd <source directory>
+ debuild
+
+Changing the build behaviour with DEB_BUILD_OPTIONS
+---------------------------------------------------
+These options are supported:
+
+ debug - build with FULL debug symbols. Default is just to build
+ with SMALL ones since the deb otherwise gets too big
+ ((>400M, ca. 1GB I-S))
+
+ ccache - enable the use of ccache during the build. This is highly
+ recommended if you plan on building the package more than
+ once, or doing any development on the packages. Be aware
+ that you need EXTRAPACKAGES="ccache" in /etc/pbuilderrc
+ when trying to build libreoffice with ccache in
+ $DEB_BUILD_OPTIONS under pbuilder (this has no effect
+ on speed, hough because the cache does not persist in
+ pbuilder)
+
+ parallel=<n>
+ - enable n projects to be built in parallel.
+ The log output can get a little confusing, and some projects
+ may fail still. You need to remove config.status if you
+ change this value after interrupting a build.
+
+ lang=<code>
+ - Build only the specified language
+
+ nocheck
+ - disable run of tests when enabled in rules
+
+
+The targets that are built during the package build
+---------------------------------------------------
+
+- targets run during the package build -
+
+unpack - Does prerequisites for the build: packing, unpacking etc.
+
+build - as the name says
+
+install - Copy files from debian/tmp/pkg into the correct locations
+ for the final package layout in debian/libreoffice*
+ where we need to do that here because it affects arch-dep
+ and arch-indep stuff and therefore cannot be done in
+ install-arch / install-indep.
+
+install-arch - installs arch-dependent stuff into the arch-dep. packages
+install-indep - " "-independent " " " "-indep. packages
+
+langpackgs - Installs the language packgs
+helppkgs - Installs the help packages
+
+maintscripts - Generates the maintainer scripts
+
+get-orig-source - gets original source tarballs and unpacks them
+ GIT_BASEURL can be set to a local mirror
+ GIT_BRANCH is the branch to clone from the repos
+ GIT_TAG is tag that should be packed
+ GIT_BRANCH and GIT_TAG can both be master
+
+Building the package from git master
+====================================
+To do a build from git master, do:
+ mkdir libreoffice-git
+ cd libreoffice-git
+ git clone https://salsa.debian.org/libreoffice-team/libreoffice/libreoffice.git debian
+ ./debian/rules unpack GIT_BRANCH=master GIT_TAG=master SOURCE_TARBALLS=n
+ dpkg-buildpackage
+
+Build system file layout
+========================
+debian/scripts:
+ Directory containing various debian-specific build-related scripts.