summaryrefslogtreecommitdiffstats
path: root/readlicense_oo/README.md
blob: 2eae0bf5c3a64a75594874cd52936f44532332f0 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
# LibreOffice Licensing Blurb

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.