summaryrefslogtreecommitdiff
path: root/readlicense_oo/README.md
diff options
context:
space:
mode:
Diffstat (limited to 'readlicense_oo/README.md')
-rw-r--r--readlicense_oo/README.md29
1 files changed, 15 insertions, 14 deletions
diff --git a/readlicense_oo/README.md b/readlicense_oo/README.md
index eb6c4482df15..2eae0bf5c3a6 100644
--- a/readlicense_oo/README.md
+++ b/readlicense_oo/README.md
@@ -1,33 +1,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
-------------------------
+## Generating Licence Files
-License files are generated from a single source file (license/license.xml).
+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.
+- The plain text and the html format is generated with XSLT. There are two
+ separate XSL files for plain text and html.
-Conditional text
-----------------
+## 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.
+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
+- `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
+- `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.
+- `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.
-- 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.
-Conditional text are surrounded by and extra <div> tag. The class attribute of
-that <div> tag decides which parameter values are taken into consideration.