summaryrefslogtreecommitdiffstats
path: root/libraries/qt5/README
diff options
context:
space:
mode:
Diffstat (limited to 'libraries/qt5/README')
-rw-r--r--libraries/qt5/README108
1 files changed, 75 insertions, 33 deletions
diff --git a/libraries/qt5/README b/libraries/qt5/README
index 1aff0e6a62..c0fc3bbad5 100644
--- a/libraries/qt5/README
+++ b/libraries/qt5/README
@@ -7,61 +7,48 @@ against if they are detected at build time:
libwebp opus pcre2 snappy
-
============================================================
OPTIONS
-To build the documentation pass DOCS=yes to the SlackBuild:
-
- DOCS=yes ./qt5.SlackBuild
-
-To build the examples pass EXAMPLES=yes to the SlackBuild:
+To use Qt's built-in ccache option:
- EXAMPLES=yes ./qt5.SlackBuild
+ CCACHE=yes ./qt5.SlackBuild
-NOTE
+See README.benchmarks for the benefits of using ccache.
-Building the documentation and examples creates a
-significantly larger package.
+To build the documentation:
+ DOCS=yes ./qt5.SlackBuild
-ROUGH SIZE GUIDE
+To build the examples:
-Package size:
+ EXAMPLES=yes ./qt5.SlackBuild
- Qt alone: 102M
- With documentation: 339M
- With examples: 391M
- With both documentation and examples: 628M
+To build support for proprietary media codecs:
-Minumum working space needed (size of source and package
-directories at end of build):
+ PROPRIETARY_CODECS=yes ./qt5.SlackBuild
- Qt alone: 5018M
- With documentation: 6197M
- With examples: 6388M
- With both documentation and examples: 7604M
+(this will produce a non-redistributable package in some
+countries)
+To disable support for pulseaudio:
-To build support for proprietary media codecs pass
-PROPRIETARY_CODECS=yes to the SlackBuild (this will produce
-a non-redistributable package in some countries):
+ PULSEAUDIO=no ./qt5.SlackBuild
- PROPRIETARY_CODECS=yes ./qt5.SlackBuild
+(Qt will automatically detect if pulseaudio is not installed
+at build time and disable it if it is missing.)
-To disable support for pulseaudio pass PULSEAUDIO=no to the
-SlackBuild:
+To NOT build qtwebengine (EXPERIMENTAL):
- PULSEAUDIO=no ./qt5.SlackBuild
+ WEBENGINE=no ./qt5.SlackBuild
-Qt will automatically detect if it is not installed at build
-time and not provide support for it.
+Combine any or all of the above.
============================================================
-NOTE
+GENERAL NOTES
After upgrading Qt5 it is important to rebuild qt5ct too, if
it is installed, or some applications may not display or
@@ -69,7 +56,62 @@ function correctly.
There is a qt5-legacy (5.7.1) SlackBuild that is available
for older applications that do not run correctly with this
-version. However it will not coexist with this version.
+version. However it will not coexist with this version.
Please report any problems about applications that don't
work correctly to the Qt5 maintainer or to the mailing list.
+
+============================================================
+
+ROUGH SPEED & SIZE GUIDE
+
+ OPTION PKG SPACE TIME
+ Normal: 102M 5018M 9:55
+ No Webengine: 50M 1895M 3:18
+ With Documentation: 339M 6197M -
+ With Examples: 391M 6388M -
+ With Documentation and Examples: 628M 7604M -
+
+ PKG: Package size.
+ SPACE: Package directory + source space needed.
+ TIME: Rough build time (- = unknown.)
+
+See README.benchmarks for more detailed information.
+See README.ccache for information on setting up ccache.
+
+============================================================
+
+NOTES ON OPTIONS
+
+* Using ccache should speed up subsequent rebuilds, but may
+ be slower for first time or one-off builds.
+
+* Building the documentation and/or examples creates a
+ significantly larger package.
+
+* Successfully tested so far without webengine (VERY quick
+ tests):
+
+ QMPlay2
+ qt5ct
+ qbittorrent-qt5
+ speedcrunch
+ qca-qt5
+ psi-plus
+ sddm
+
+============================================================
+
+BUILDING WITHOUT WEBENGINE
+
+See README.benchmarks for the benefits of not building
+webengine.
+
+YMMV whether it works with an application or not, but if you
+have no intention of using the browser code, which includes
+a chunk of 3rd party Google Chromium source, then it may
+make sense to skip it and save yourself about 2/3 of the
+build time.
+
+The package version has _nowebengine appended to it for
+clarity.