KDEInstallDirs
Define KDE standard installation directories.
Note that none of the variables defined by this module provide any
information about the location of already-installed KDE software.
Inclusion of this module defines the following variables:
- CMAKE_INSTALL_<dir>
- destination for files of a given type
- CMAKE_INSTALL_FULL_<dir>
- corresponding absolute path
where <dir> is one of (default values in parentheses and alternative,
deprecated variable name in square brackets):
- BUNDLEDIR
- application bundles (/Applications/KDE) [BUNDLE_INSTALL_DIR]
- EXECROOTDIR
- executables and libraries (<empty>) [EXEC_INSTALL_PREFIX]
- BINDIR
- user executables (EXECROOTDIR/bin) [BIN_INSTALL_DIR]
- SBINDIR
- system admin executables (EXECROOTDIR/sbin) [SBIN_INSTALL_DIR]
- LIBDIR
- object code libraries (EXECROOTDIR/lib, EXECROOTDIR/lib64 or
EXECROOTDIR/lib/<multiarch-tuple on Debian) [LIB_INSTALL_DIR]
- LIBEXECDIR
- executables for internal use by programs and libraries (BINDIR on
Windows, LIBDIR/libexec otherwise) [LIBEXEC_INSTALL_DIR]
- CMAKEPACKAGEDIR
- CMake packages, including config files (LIBDIR/cmake)
[CMAKECONFIG_INSTALL_PREFIX]
- QTPLUGINDIR
- Qt plugins (LIBDIR/plugins) [QT_PLUGIN_INSTALL_DIR]
- PLUGINDIR
- Plugins (QTPLUGINDIR) [PLUGIN_INSTALL_DIR]
- QTQUICKIMPORTSDIR
- QtQuick1 imports (QTPLUGINDIR/imports) [IMPORTS_INSTALL_DIR]
- QMLDIR
- QtQuick2 imports (LIBDIR/qml) [QML_INSTALL_DIR]
- INCLUDEDIR
- C and C++ header files (include) [INCLUDE_INSTALL_DIR]
- LOCALSTATEDIR
- modifiable single-machine data (var)
- SHAREDSTATEDIR
- modifiable architecture-independent data (com)
- DATAROOTDIR
- read-only architecture-independent data root (share)
[SHARE_INSTALL_PREFIX]
- DATADIR
- read-only architecture-independent data (DATAROOTDIR)
[DATA_INSTALL_DIR]
- DOCBUNDLEDIR
- documentation bundles generated using kdoctools
(DATAROOTDIR/doc/HTML) [HTML_INSTALL_DIR]
- KCFGDIR
- kconfig description files (DATAROOTDIR/config.kcfg)
[KCFG_INSTALL_DIR]
- KCONFUPDATEDIR
- kconf_update scripts (DATAROOTDIR/kconf_update)
[KCONF_UPDATE_INSTALL_DIR]
- KSERVICES5DIR
- services for KDE Frameworks 5 (DATAROOTDIR/kservices5)
[SERVICES_INSTALL_DIR]
- KSERVICETYPES5DIR
- service types for KDE Frameworks 5 (DATAROOTDIR/kservicetypes5)
[SERVICETYPES_INSTALL_DIR]
- KXMLGUI5DIR
- knotify description files (DATAROOTDIR/kxmlgui5)
[KXMLGUI_INSTALL_DIR]
- KNOTIFY5RCDIR
- knotify description files (DATAROOTDIR/knotifications5)
[KNOTIFYRC_INSTALL_DIR]
- ICONDIR
- icons (DATAROOTDIR/icons) [ICON_INSTALL_DIR]
- LOCALEDIR
- knotify description files (DATAROOTDIR/locale)
[LOCALE_INSTALL_DIR]
- SOUNDDIR
- sound files (DATAROOTDIR/sounds) [SOUND_INSTALL_DIR]
- TEMPLATEDIR
- templates (DATAROOTDIR/templates) [TEMPLATES_INSTALL_DIR]
- WALLPAPERDIR
- desktop wallpaper images (DATAROOTDIR/wallpapers)
[WALLPAPER_INSTALL_DIR]
- APPDIR
- application desktop files (DATAROOTDIR/applications)
[XDG_APPS_INSTALL_DIR]
- DESKTOPDIR
- desktop directories (DATAROOTDIR/desktop-directories)
[XDG_DIRECTORY_INSTALL_DIR]
- MIMEDIR
- mime description files (DATAROOTDIR/mime/packages)
[XDG_MIME_INSTALL_DIR]
- METAINFODIR
- AppStream component metadata files (DATAROOTDIR/appdata)
- MANDIR
- man documentation (DATAROOTDIR/man) [MAN_INSTALL_DIR]
- INFODIR
- info documentation (DATAROOTDIR/info)
- DBUSDIR
- D-Bus (DATAROOTDIR/dbus-1)
- DBUSINTERFACEDIR
- D-Bus interfaces (DBUSDIR/interfaces)
[DBUS_INTERFACES_INSTALL_DIR]
- DBUSSERVICEDIR
- D-Bus session services (DBUSDIR/services)
[DBUS_SERVICES_INSTALL_DIR]
- DBUSSYSTEMSERVICEDIR
- D-Bus system services (DBUSDIR/system-services)
[DBUS_SYSTEM_SERVICES_INSTALL_DIR]
- SYSCONFDIR
- read-only single-machine data (etc) [SYSCONF_INSTALL_DIR]
- CONFDIR
- application configuration files (SYSCONFDIR/xdg)
[CONFIG_INSTALL_DIR]
- AUTOSTARTDIR
- autostart files (CONFDIR/autostart) [AUTOSTART_INSTALL_DIR]
The CMAKE_INSTALL_<dir> variables (or their deprecated counterparts) may
be passed to the DESTINATION options of install() commands for the
corresponding file type. They are set in the CMake cache, and so the
defaults above can be overridden by users.
Note that either the CMAKE_INSTALL_<dir> form of the variable or the
deprecated form can be changed using CMake command line variable definitions;
in either case, both forms of the variable will be affected. The effect of
passing both forms on the command line is undefined.
The variable INSTALL_TARGETS_DEFAULT_ARGS is also defined. This should
be used when libraries or user-executable applications are installed, in the
following manner:
install(TARGETS mylib myapp ${INSTALL_TARGETS_DEFAULT_ARGS})
It MUST NOT be used for installing plugins, system admin executables or
executables only intended for use internally by other code. Those should use
CMAKE_INSTALL_PLUGINDIR, CMAKE_INSTALL_SBINDIR or
CMAKE_INSTALL_LIBEXECDIR respectively.