summaryrefslogtreecommitdiffstats
path: root/readlicense_oo/README
diff options
context:
space:
mode:
authorDaniel Baumann <daniel.baumann@progress-linux.org>2024-04-27 16:51:28 +0000
committerDaniel Baumann <daniel.baumann@progress-linux.org>2024-04-27 16:51:28 +0000
commit940b4d1848e8c70ab7642901a68594e8016caffc (patch)
treeeb72f344ee6c3d9b80a7ecc079ea79e9fba8676d /readlicense_oo/README
parentInitial commit. (diff)
downloadlibreoffice-940b4d1848e8c70ab7642901a68594e8016caffc.tar.xz
libreoffice-940b4d1848e8c70ab7642901a68594e8016caffc.zip
Adding upstream version 1:7.0.4.upstream/1%7.0.4upstream
Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>
Diffstat (limited to 'readlicense_oo/README')
-rw-r--r--readlicense_oo/README33
1 files changed, 33 insertions, 0 deletions
diff --git a/readlicense_oo/README b/readlicense_oo/README
new file mode 100644
index 000000000..eb6c4482d
--- /dev/null
+++ b/readlicense_oo/README
@@ -0,0 +1,33 @@
+Contains the stock libreoffice licensing blurb, as distributed in the install
+directory, and also potentially at run-time.
+
+Generating licence files
+------------------------
+
+License files are generated from a single source file (license/license.xml).
+Output file formats are plain text and html.
+
+- The plain text and the html format is generated with xslt. There are two
+ separate xsl files for plain text and html.
+
+Conditional text
+----------------
+
+The contents of the license file depends on the build configuration. Several
+externals may or may not be shipped with LibreOffice. Therefore, we need to pass
+information about build configuration to the xslt processor.
+
+Variables used for conditional text:
+
+- BUILD_TYPE: A space separated list of libraries/externals. If an external is
+ present in that list, then the related license text should be included.
+
+- MPL_SUBSET: If the variable is defined, then GPL and LGPL license text will not
+ be included, because none of the built-in code need it.
+
+- OS: The target platform. E.g. MSVC Runtime is packaged and used only on Windows.
+
+- WITH_THEMES: A space separated list of icon sets that are used in the build.
+
+Conditional text are surrounded by and extra <div> tag. The class attribute of
+that <div> tag decides which parameter values are taken into consideration.