readlicense_oo/README.md

   1 # LibreOffice Licensing Blurb
   2
   3 Contains the stock libreoffice licensing blurb, as distributed in the install
   4 directory, and also potentially at run-time.
   5
   6 ## Generating Licence Files
   7
   8 License files are generated from a single source file (`license/license.xml`).
   9 Output file formats are plain text and html.
  10
  11 - The plain text and the html format is generated with XSLT. There are two
  12   separate XSL files for plain text and html.
  13
  14 ## Conditional Text
  15
  16 The contents of the license file depends on the build configuration. Several
  17 externals may or may not be shipped with LibreOffice. Therefore, we need to pass
  18 information about build configuration to the XSLT processor.
  19
  20 Variables used for conditional text:
  21
  22 - `BUILD_TYPE`: A space separated list of libraries/externals. If an external is
  23   present in that list, then the related license text should be included.
  24
  25 - `MPL_SUBSET`: If the variable is defined, then GPL and LGPL license text will not
  26   be included, because none of the built-in code need it.
  27
  28 - `OS`: The target platform. E.g. MSVC Runtime is packaged and used only on Windows.
  29
  30 - `WITH_THEMES`: A space separated list of icon sets that are used in the build.
  31
  32 Conditional text are surrounded by and extra `<div>` tag. The class attribute of
  33 that `<div>` tag decides which parameter values are taken into consideration.
  34