Warning, /system/qtcurve/README.md is written in an unsupported language. File is not indexed.

0001 # Installation
0002 ## Build and install
0003 
0004     mkdir build
0005     cd build
0006     cmake .. -DCMAKE_INSTALL_PREFIX=/usr
0007     make
0008     make install
0009 
0010 ## CMake configure arguments
0011 1. `ENABLE_QT4`:
0012 
0013     Building QtCurve Qt4 theme.
0014 
0015     (Default: `On`)
0016 
0017 2. `ENABLE_QT5`:
0018 
0019     Building QtCurve Qt5 theme.
0020 
0021     (Default: `On`)
0022 
0023 3. `ENABLE_GTK2`:
0024 
0025     Building QtCurve Gtk2 theme.
0026 
0027     (Default: `On`)
0028 
0029 4. `QTC_ENABLE_X11`:
0030 
0031     Enable X11 support. Require `xcb`, `xlib-xcb`. Will cause
0032     `libqtcurve-utils.so` to link to `libxcb`, `libX11-xcb` and `libX11`.
0033 
0034     NOTE: this options will not affect any modules/libraries other than
0035     `libqtcurve-utils.so`. `libqtcurve-utils.so` with/without the option
0036     are API and ABI compatible although some functions will be NO-OP with
0037     X11 disabled.
0038 
0039     (Default: `On`)
0040 
0041 5. `QTC_INSTALL_PO`:
0042 
0043     Install `*.po` translation files.
0044 
0045     (Default: `On`)
0046 
0047 6. `QTC_QT4_ENABLE_KDE`:
0048 
0049     Compile QtCurve qt4 style with KDE support and dependencies.
0050 
0051     (Default: `On`)
0052 
0053 7. `QTC_QT4_ENABLE_KWIN`:
0054 
0055     Compile QtCurve qt4 kwin style. This will only have effect when KDE support
0056     is turned on. Also require a X11 build of Qt4 and `libxcb` headers.
0057 
0058     (Default: `On` if kwin header is found and KDE support is on,
0059     `Off` otherwise)
0060 
0061 8. `QTC_KDE4_PREFIX`:
0062 
0063     The install prefix of KDE4.
0064 
0065     (Default: the value returned by `kde4-config` or `${CMAKE_INSTALL_PREFIX}`
0066     if `kde4-config` is not found.)
0067 
0068 9. `QTC_KDE4_ICONS_PREFIX`:
0069 
0070     The path of KDE4 icons.
0071 
0072     (Default: `${QTC_KDE4_PREFIX}/share/icons`)
0073 
0074 10. `QTC_QT5_ENABLE_KDE`:
0075 
0076      Compile QtCurve qt5 style with KDE Frameworks support and dependencies.
0077 
0078      (Default: `On`)
0079 
0080 ## Deprecated and temporary options.
0081 These compile options were used to turn on/off some experimental features or
0082 work around for certain hardware/software/drivers. It is not guaranteed that
0083 any of the non-default value of these options can work and some of these
0084 options may crash certain applications. They may also be removed at any time
0085 (especially the ones to work around old hardware or driver bugs) and are not
0086 recommanded to turn on in distribution packages.
0087 
0088 1. `QTC_QT4_STYLE_SUPPORT`:
0089 
0090     Support QtCurve style files. These are stored as
0091     `<kde prefix>/share/apps/kstyle/themes/qtc_<stylename>.themerc`
0092     Note that this is not supported in Qt5.
0093 
0094     (Default: `Off`)
0095 
0096 # Additional Features
0097 ## XBar/MacMenu
0098 The XBar support was copied directly from Bespin. The relevant files are named
0099 `macmenu.*`. These were taken from revision 652.
0100 
0101 **Deprecated** in favor of appmenu since KWin has builtin support for that
0102 after `4.10` and `appmenu-qt` does not depend on a certain theme.
0103 
0104 ## Themes
0105 As of v0.55, you can create QtCurve based themes. These will appear with KDE's
0106 style control panel's combobox of styles. To create a new theme, select
0107 'QtCurve' from within KDE's style panel, then configure QtCurve as required.
0108 After this, in QtCurve's config dialog, select 'Export theme' from the options
0109 menu button. You will then be prompted to give your new 'theme' a name, and a
0110 comment. QtCurve will then create a file named `qtc_<name>.themerc`
0111 (e.g. `qtc_klearlooks.themerc`) - this will have the following format:
0112 
0113     [Misc]
0114     Name=Klearlooks
0115     Comment=Clearlooks inspired style
0116     [KDE]
0117     WidgetStyle=qtc_klearlooks
0118     [Settings]
0119     animatedProgress=false
0120     appearance=gradient
0121     ....rest of qtcurve settings...
0122 
0123 To use this theme, either copy `qtc_<name>.themerc` to
0124 `$KDEHOME/share/apps/kstyle/themes/`
0125 (usually `~/.kde/share/apps/kstyle/themes/`)
0126 or copy to `<kde install prefix>/share/apps/kstyle/themes/`
0127 (usually `/usr/share/apps/kstyle/themes/`)
0128 
0129 When KDE's style panel is restarted, your new theme should appear in the list.
0130 
0131 **NOTE**: As of QtCurve 1.0.0 style support has been disabled by default (enable
0132 via `QTC_QT4_STYLE_SUPPORT`) and this is not supported by Qt5.
0133 
0134 ## Testing
0135 As of v1.2.1, QtCurve can be forced to read its settings from an alternate
0136 config file via the `QTCURVE_CONFIG_FILE` environment variable. This is only
0137 really useful for testing alternate config settings without changing the users
0138 current settings.
0139 
0140 Usage:
0141 
0142     QTCURVE_CONFIG_FILE=~/testfile kcalc
0143 
0144 # Compiler versions requirement
0145 QtCurve requires the GNU dialect of ISO C99 and ISO C++11 (which means the
0146 compilers have to support `-std=gnu99` and `-std=c++0x` command line option).
0147 `g++>=4.7` and `clang++>=3.3` are fully supported. C compiler for any
0148 reasonable version of gcc and clang should all work well.
0149 
0150 For g++ older than 4.7, you need `-Doverride=` in the `CXXFLAGS` since it
0151 does not support the override keyword in c++11. The trick should work down to
0152 g++ 4.4 for the Qt4 style and 4.6 for the Qt5 stle.
0153 
0154 clang++ 3.3 is not compatible with the stdc++ header shipped with gcc 4.7 so
0155 libc++ is required when compiling with clang++ 3.3.
0156 
0157 # License
0158 QtCurve `1.8.17` and earlier was licensed under GPLv2+. It was relicensed under
0159 LGPLv2.1+ on Nov. 14th 2013 in order to avoid confusion for moving into
0160 KDE-infrastructure. This relicensing have got permissions from all contributors
0161 of QtCurve (`git log --format='%aN <%aE>' | sort -u`):
0162 
0163     Andrey Bondrov <andrey.bondrov@rosalab.ru>
0164     Boris Pek <tehnick-8@yandex.ru>
0165     Craig Drummond <craig.p.drummond@gmail.com>
0166     Sven-Hendrik Haase <sh@lutzhaase.com>
0167     Yichao Yu <yyc1992@gmail.com>