kolan
/
CMake
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity

CPackRPM and CPackDeb documentation improvements

This commit is contained in:
Domen Vrankar 2016-05-31 22:06:39 +02:00 committed by Brad King
parent ebcc13e1b3
commit 20e55e4be8
2 changed files with 165 additions and 113 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

71
Modules/CPackDeb.cmake
View File

@ -2,29 +2,44 @@
# CPackDeb # CPackDeb
# -------- # --------
# #
# The builtin (binary) CPack Deb generator (Unix only) # The built in (binary) CPack Deb generator (Unix only)
# #
# Variables specific to CPack Debian (DEB) generator # Variables specific to CPack Debian (DEB) generator
# ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ # ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
# #
# CPackDeb may be used to create Deb package using CPack. # CPackDeb may be used to create Deb package using :module:`CPack`.
# CPackDeb is a CPack generator thus it uses the ``CPACK_XXX`` variables # CPackDeb is a :module:`CPack` generator thus it uses the ``CPACK_XXX``
# used by CPack : https://cmake.org/Wiki/CMake:CPackConfiguration. # variables used by :module:`CPack`.
# CPackDeb generator should work on any linux host but it will produce #
# better deb package when Debian specific tools 'dpkg-xxx' are usable on # CPackDeb generator should work on any Linux host but it will produce
# better deb package when Debian specific tools ``dpkg-xxx`` are usable on
# the build system. # the build system.
# #
# CPackDeb has specific features which are controlled by the specifics # CPackDeb has specific features which are controlled by the specifics
# :code:`CPACK_DEBIAN_XXX` variables. # :code:`CPACK_DEBIAN_XXX` variables.
# #
# :code:`CPACK_DEBIAN_<COMPONENT>_XXXX` variables may be used in order to have # :code:`CPACK_DEBIAN_<COMPONENT>_XXXX` variables may be used in order to have
# **component** specific values. Note however that ``<COMPONENT>`` refers to the # **component** specific values. Note however that ``<COMPONENT>`` refers to
# **grouping name** written in upper case. It may be either a component name or # the **grouping name** written in upper case. It may be either a component name
# a component GROUP name. # or a component GROUP name.
# #
# You'll find a detailed usage on the wiki: # Here are some CPackDeb wiki resources that are here for historic reasons and
# https://cmake.org/Wiki/CMake:CPackPackageGenerators#DEB_.28UNIX_only.29 . # are no longer maintained but may still prove useful:
# However as a handy reminder here comes the list of specific variables: #
# - https://cmake.org/Wiki/CMake:CPackConfiguration
# - https://cmake.org/Wiki/CMake:CPackPackageGenerators#DEB_.28UNIX_only.29
#
# List of CPackRPM specific variables:
#
# .. variable:: CPACK_DEB_PACKAGE_COMPONENT
#
# Enable component packaging for CPackRPM
#
# * Mandatory : NO
# * Default : OFF
#
# If enabled (ON) multiple packages are generated. By default a single package
# containing files of all components is generated.
# #
# .. variable:: CPACK_DEBIAN_PACKAGE_NAME # .. variable:: CPACK_DEBIAN_PACKAGE_NAME
# CPACK_DEBIAN_<COMPONENT>_PACKAGE_NAME # CPACK_DEBIAN_<COMPONENT>_PACKAGE_NAME
@ -55,7 +70,7 @@
# #
# <PackageName>_<VersionNumber>-<DebianRevisionNumber>_<DebianArchitecture>.deb # <PackageName>_<VersionNumber>-<DebianRevisionNumber>_<DebianArchitecture>.deb
# #
# Alternatively provided package file name must end with ".deb" suffix. # Alternatively provided package file name must end with ``.deb`` suffix.
# #
# .. note:: # .. note::
# #
@ -98,7 +113,6 @@
# * Default : Output of :code:`dpkg --print-architecture` (or :code:`i386` # * Default : Output of :code:`dpkg --print-architecture` (or :code:`i386`
# if :code:`dpkg` is not found) # if :code:`dpkg` is not found)
# #
#
# .. variable:: CPACK_DEBIAN_PACKAGE_DEPENDS # .. variable:: CPACK_DEBIAN_PACKAGE_DEPENDS
# CPACK_DEBIAN_<COMPONENT>_PACKAGE_DEPENDS # CPACK_DEBIAN_<COMPONENT>_PACKAGE_DEPENDS
# #
@ -141,7 +155,6 @@
# * Mandatory : YES # * Mandatory : YES
# * Default : :code:`CPACK_PACKAGE_CONTACT` # * Default : :code:`CPACK_PACKAGE_CONTACT`
# #
#
# .. variable:: CPACK_DEBIAN_PACKAGE_DESCRIPTION # .. variable:: CPACK_DEBIAN_PACKAGE_DESCRIPTION
# CPACK_COMPONENT_<COMPONENT>_DESCRIPTION # CPACK_COMPONENT_<COMPONENT>_DESCRIPTION
# #
@ -160,19 +173,23 @@
# Set Section control field e.g. admin, devel, doc, ... # Set Section control field e.g. admin, devel, doc, ...
# #
# * Mandatory : YES # * Mandatory : YES
# * Default : 'devel' # * Default : "devel"
# #
# See https://www.debian.org/doc/debian-policy/ch-archive.html#s-subsections # See https://www.debian.org/doc/debian-policy/ch-archive.html#s-subsections
# #
#
# .. variable:: CPACK_DEBIAN_COMPRESSION_TYPE # .. variable:: CPACK_DEBIAN_COMPRESSION_TYPE
# #
# The compression used for creating the Debian package. # The compression used for creating the Debian package.
# Possible values are: lzma, xz, bzip2 and gzip.
# #
# * Mandatory : YES # * Mandatory : YES
# * Default : 'gzip' # * Default : "gzip"
# #
# Possible values are:
#
# - lzma
# - xz
# - bzip2
# - gzip
# #
# .. variable:: CPACK_DEBIAN_PACKAGE_PRIORITY # .. variable:: CPACK_DEBIAN_PACKAGE_PRIORITY
# CPACK_DEBIAN_<COMPONENT>_PACKAGE_PRIORITY # CPACK_DEBIAN_<COMPONENT>_PACKAGE_PRIORITY
@ -181,11 +198,10 @@
# extra # extra
# #
# * Mandatory : YES # * Mandatory : YES
# * Default : 'optional' # * Default : "optional"
# #
# See https://www.debian.org/doc/debian-policy/ch-archive.html#s-priorities # See https://www.debian.org/doc/debian-policy/ch-archive.html#s-priorities
# #
#
# .. variable:: CPACK_DEBIAN_PACKAGE_HOMEPAGE # .. variable:: CPACK_DEBIAN_PACKAGE_HOMEPAGE
# #
# The URL of the web site for this package, preferably (when applicable) the # The URL of the web site for this package, preferably (when applicable) the
@ -200,7 +216,6 @@
# The content of this field is a simple URL without any surrounding # The content of this field is a simple URL without any surrounding
# characters such as <>. # characters such as <>.
# #
#
# .. variable:: CPACK_DEBIAN_PACKAGE_SHLIBDEPS # .. variable:: CPACK_DEBIAN_PACKAGE_SHLIBDEPS
# CPACK_DEBIAN_<COMPONENT>_PACKAGE_SHLIBDEPS # CPACK_DEBIAN_<COMPONENT>_PACKAGE_SHLIBDEPS
# #
@ -220,7 +235,6 @@
# may fail to find your own shared libs. # may fail to find your own shared libs.
# See https://cmake.org/Wiki/CMake_RPATH_handling. # See https://cmake.org/Wiki/CMake_RPATH_handling.
# #
#
# .. variable:: CPACK_DEBIAN_PACKAGE_DEBUG # .. variable:: CPACK_DEBIAN_PACKAGE_DEBUG
# #
# May be set when invoking cpack in order to trace debug information # May be set when invoking cpack in order to trace debug information
@ -284,7 +298,6 @@
# #
# See https://www.debian.org/doc/debian-policy/ch-relationships.html#s-breaks # See https://www.debian.org/doc/debian-policy/ch-relationships.html#s-breaks
# #
#
# .. variable:: CPACK_DEBIAN_PACKAGE_CONFLICTS # .. variable:: CPACK_DEBIAN_PACKAGE_CONFLICTS
# CPACK_DEBIAN_<COMPONENT>_PACKAGE_CONFLICTS # CPACK_DEBIAN_<COMPONENT>_PACKAGE_CONFLICTS
# #
@ -326,7 +339,6 @@
# #
# See https://www.debian.org/doc/debian-policy/ch-relationships.html#s-virtual # See https://www.debian.org/doc/debian-policy/ch-relationships.html#s-virtual
# #
#
# .. variable:: CPACK_DEBIAN_PACKAGE_REPLACES # .. variable:: CPACK_DEBIAN_PACKAGE_REPLACES
# CPACK_DEBIAN_<COMPONENT>_PACKAGE_REPLACES # CPACK_DEBIAN_<COMPONENT>_PACKAGE_REPLACES
# #
@ -343,7 +355,6 @@
# #
# See http://www.debian.org/doc/debian-policy/ch-relationships.html#s-binarydeps # See http://www.debian.org/doc/debian-policy/ch-relationships.html#s-binarydeps
# #
#
# .. variable:: CPACK_DEBIAN_PACKAGE_RECOMMENDS # .. variable:: CPACK_DEBIAN_PACKAGE_RECOMMENDS
# CPACK_DEBIAN_<COMPONENT>_PACKAGE_RECOMMENDS # CPACK_DEBIAN_<COMPONENT>_PACKAGE_RECOMMENDS
# #
@ -360,7 +371,6 @@
# #
# See http://www.debian.org/doc/debian-policy/ch-relationships.html#s-binarydeps # See http://www.debian.org/doc/debian-policy/ch-relationships.html#s-binarydeps
# #
#
# .. variable:: CPACK_DEBIAN_PACKAGE_SUGGESTS # .. variable:: CPACK_DEBIAN_PACKAGE_SUGGESTS
# CPACK_DEBIAN_<COMPONENT>_PACKAGE_SUGGESTS # CPACK_DEBIAN_<COMPONENT>_PACKAGE_SUGGESTS
# #
@ -376,14 +386,13 @@
# #
# See http://www.debian.org/doc/debian-policy/ch-relationships.html#s-binarydeps # See http://www.debian.org/doc/debian-policy/ch-relationships.html#s-binarydeps
# #
#
# .. variable:: CPACK_DEBIAN_PACKAGE_GENERATE_SHLIBS # .. variable:: CPACK_DEBIAN_PACKAGE_GENERATE_SHLIBS
# #
# * Mandatory : NO # * Mandatory : NO
# * Default : OFF # * Default : OFF
# #
# Allows to generate shlibs control file automatically. Compatibility is defined by # Allows to generate shlibs control file automatically. Compatibility is defined by
# CPACK_DEBIAN_PACKAGE_GENERATE_SHLIBS_POLICY variable value. # :variable:`CPACK_DEBIAN_PACKAGE_GENERATE_SHLIBS_POLICY` variable value.
# #
# .. note:: # .. note::
# #
@ -391,9 +400,10 @@
# set. This can be done by setting SOVERSION property with # set. This can be done by setting SOVERSION property with
# :command:`set_target_properties` command. # :command:`set_target_properties` command.
# #
#
# .. variable:: CPACK_DEBIAN_PACKAGE_GENERATE_SHLIBS_POLICY # .. variable:: CPACK_DEBIAN_PACKAGE_GENERATE_SHLIBS_POLICY
# #
# Compatibility policy for auto-generated shlibs control file.
#
# * Mandatory : NO # * Mandatory : NO
# * Default : "=" # * Default : "="
# #
@ -402,7 +412,6 @@
# #
# See https://www.debian.org/doc/debian-policy/ch-sharedlibs.html#s-sharedlibs-shlibdeps # See https://www.debian.org/doc/debian-policy/ch-sharedlibs.html#s-sharedlibs-shlibdeps
# #
#
# .. variable:: CPACK_DEBIAN_PACKAGE_CONTROL_EXTRA # .. variable:: CPACK_DEBIAN_PACKAGE_CONTROL_EXTRA
# CPACK_DEBIAN_<COMPONENT>_PACKAGE_CONTROL_EXTRA # CPACK_DEBIAN_<COMPONENT>_PACKAGE_CONTROL_EXTRA
# #

195
Modules/CPackRPM.cmake
View File

@ -2,14 +2,14 @@
# CPackRPM # CPackRPM
# -------- # --------
# #
# The builtin (binary) CPack RPM generator (Unix only) # The built in (binary) CPack RPM generator (Unix only)
# #
# Variables specific to CPack RPM generator # Variables specific to CPack RPM generator
# ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ # ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
# #
# CPackRPM may be used to create RPM package using CPack. # CPackRPM may be used to create RPM packages using :module:`CPack`.
# CPackRPM is a CPack generator thus it uses the ``CPACK_XXX`` variables # CPackRPM is a :module:`CPack` generator thus it uses the ``CPACK_XXX``
# used by CPack : https://cmake.org/Wiki/CMake:CPackConfiguration. # variables used by :module:`CPack`.
# #
# CPackRPM has specific features which are controlled by the specifics # CPackRPM has specific features which are controlled by the specifics
# :code:`CPACK_RPM_XXX` variables. # :code:`CPACK_RPM_XXX` variables.
@ -17,8 +17,8 @@
# :code:`CPACK_RPM_<COMPONENT>_XXXX` variables may be used in order to have # :code:`CPACK_RPM_<COMPONENT>_XXXX` variables may be used in order to have
# **component** specific values. Note however that ``<COMPONENT>`` refers to the # **component** specific values. Note however that ``<COMPONENT>`` refers to the
# **grouping name** written in upper case. It may be either a component name or # **grouping name** written in upper case. It may be either a component name or
# a component GROUP name. Usually those vars correspond to RPM spec file # a component GROUP name. Usually those variables correspond to RPM spec file
# entities, one may find information about spec files here # entities. One may find information about spec files here
# http://www.rpm.org/wiki/Docs # http://www.rpm.org/wiki/Docs
# #
# .. note:: # .. note::
@ -34,9 +34,23 @@
# component variables also override upper cased versions where both are # component variables also override upper cased versions where both are
# present. # present.
# #
# List of CPack/RPM specific variables: # Here are some CPackRPM wiki resources that are here for historic reasons and
# https://cmake.org/Wiki/CMake:CPackPackageGenerators#DEB_.28UNIX_only.29 . # are no longer maintained but may still prove useful:
# However as a handy reminder here comes the list of specific variables: #
# - https://cmake.org/Wiki/CMake:CPackConfiguration
# - https://cmake.org/Wiki/CMake:CPackPackageGenerators#RPM_.28Unix_Only.29
#
# List of CPackRPM specific variables:
#
# .. variable:: CPACK_RPM_PACKAGE_COMPONENT
#
# Enable component packaging for CPackRPM
#
# * Mandatory : NO
# * Default : OFF
#
# If enabled (ON) multiple packages are generated. By default a single package
# containing files of all components is generated.
# #
# .. variable:: CPACK_RPM_PACKAGE_SUMMARY # .. variable:: CPACK_RPM_PACKAGE_SUMMARY
# CPACK_RPM_<component>_PACKAGE_SUMMARY # CPACK_RPM_<component>_PACKAGE_SUMMARY
@ -44,7 +58,7 @@
# The RPM package summary. # The RPM package summary.
# #
# * Mandatory : YES # * Mandatory : YES
# * Default : CPACK_PACKAGE_DESCRIPTION_SUMMARY # * Default : :variable:`CPACK_PACKAGE_DESCRIPTION_SUMMARY`
# #
# .. variable:: CPACK_RPM_PACKAGE_NAME # .. variable:: CPACK_RPM_PACKAGE_NAME
# CPACK_RPM_<component>_PACKAGE_NAME # CPACK_RPM_<component>_PACKAGE_NAME
@ -52,7 +66,7 @@
# The RPM package name. # The RPM package name.
# #
# * Mandatory : YES # * Mandatory : YES
# * Default : CPACK_PACKAGE_NAME # * Default : :variable:`CPACK_PACKAGE_NAME`
# #
# .. variable:: CPACK_RPM_FILE_NAME # .. variable:: CPACK_RPM_FILE_NAME
# CPACK_RPM_<component>_FILE_NAME # CPACK_RPM_<component>_FILE_NAME
@ -65,7 +79,7 @@
# #
# This may be set to ``RPM-DEFAULT`` to allow rpmbuild tool to generate package # This may be set to ``RPM-DEFAULT`` to allow rpmbuild tool to generate package
# file name by itself. # file name by itself.
# Alternatively provided package file name must end with ".rpm" suffix. # Alternatively provided package file name must end with ``.rpm`` suffix.
# #
# .. note:: # .. note::
# #
@ -83,7 +97,7 @@
# The RPM package version. # The RPM package version.
# #
# * Mandatory : YES # * Mandatory : YES
# * Default : CPACK_PACKAGE_VERSION # * Default : :variable:`CPACK_PACKAGE_VERSION`
# #
# .. variable:: CPACK_RPM_PACKAGE_ARCHITECTURE # .. variable:: CPACK_RPM_PACKAGE_ARCHITECTURE
# CPACK_RPM_<component>_PACKAGE_ARCHITECTURE # CPACK_RPM_<component>_PACKAGE_ARCHITECTURE
@ -91,9 +105,9 @@
# The RPM package architecture. # The RPM package architecture.
# #
# * Mandatory : YES # * Mandatory : YES
# * Default : Native architecture output by "uname -m" # * Default : Native architecture output by ``uname -m``
# #
# This may be set to "noarch" if you know you are building a noarch package. # This may be set to ``noarch`` if you know you are building a noarch package.
# #
# .. variable:: CPACK_RPM_PACKAGE_RELEASE # .. variable:: CPACK_RPM_PACKAGE_RELEASE
# #
@ -161,9 +175,9 @@
# RPM package description. # RPM package description.
# #
# * Mandatory : YES # * Mandatory : YES
# * Default : CPACK_COMPONENT_<compName>_DESCRIPTION (component based installers # * Default : :variable:`CPACK_COMPONENT_<compName>_DESCRIPTION` (component
# only) if set, CPACK_PACKAGE_DESCRIPTION_FILE if set or "no package # based installers only) if set, :variable:`CPACK_PACKAGE_DESCRIPTION_FILE`
# description available" # if set or "no package description available"
# #
# .. variable:: CPACK_RPM_COMPRESSION_TYPE # .. variable:: CPACK_RPM_COMPRESSION_TYPE
# #
@ -175,7 +189,14 @@
# May be used to override RPM compression type to be used to build the # May be used to override RPM compression type to be used to build the
# RPM. For example some Linux distribution now default to lzma or xz # RPM. For example some Linux distribution now default to lzma or xz
# compression whereas older cannot use such RPM. Using this one can enforce # compression whereas older cannot use such RPM. Using this one can enforce
# compression type to be used. Possible value are: lzma, xz, bzip2 and gzip. # compression type to be used.
#
# Possible values are:
#
# - lzma
# - xz
# - bzip2
# - gzip
# #
# .. variable:: CPACK_RPM_PACKAGE_AUTOREQ # .. variable:: CPACK_RPM_PACKAGE_AUTOREQ
# CPACK_RPM_<component>_PACKAGE_AUTOREQ # CPACK_RPM_<component>_PACKAGE_AUTOREQ
@ -190,7 +211,7 @@
# #
# .. note:: # .. note::
# #
# By defalut automatic dependency detection is enabled by rpm generator. # By default automatic dependency detection is enabled by rpm generator.
# #
# .. variable:: CPACK_RPM_PACKAGE_AUTOPROV # .. variable:: CPACK_RPM_PACKAGE_AUTOPROV
# CPACK_RPM_<component>_PACKAGE_AUTOPROV # CPACK_RPM_<component>_PACKAGE_AUTOPROV
@ -206,7 +227,7 @@
# #
# .. note:: # .. note::
# #
# By defalut automatic provides detection is enabled by rpm generator. # By default automatic provides detection is enabled by rpm generator.
# #
# .. variable:: CPACK_RPM_PACKAGE_AUTOREQPROV # .. variable:: CPACK_RPM_PACKAGE_AUTOREQPROV
# CPACK_RPM_<component>_PACKAGE_AUTOREQPROV # CPACK_RPM_<component>_PACKAGE_AUTOREQPROV
@ -222,7 +243,7 @@
# #
# .. note:: # .. note::
# #
# By defalut automatic detection feature is enabled by rpm. # By default automatic detection feature is enabled by rpm.
# #
# .. variable:: CPACK_RPM_PACKAGE_REQUIRES # .. variable:: CPACK_RPM_PACKAGE_REQUIRES
# CPACK_RPM_<component>_PACKAGE_REQUIRES # CPACK_RPM_<component>_PACKAGE_REQUIRES
@ -249,8 +270,8 @@
# * Mandatory : NO # * Mandatory : NO
# * Default : - # * Default : -
# #
# May be used to set negative RPM dependencies (conflicts). Note that you must enclose # May be used to set negative RPM dependencies (conflicts). Note that you must
# the complete requires string between quotes, for example:: # enclose the complete requires string between quotes, for example::
# #
# set(CPACK_RPM_PACKAGE_CONFLICTS "libxml2") # set(CPACK_RPM_PACKAGE_CONFLICTS "libxml2")
# #
@ -266,8 +287,8 @@
# * Mandatory : NO # * Mandatory : NO
# * Default : - # * Default : -
# #
# May be used to set RPM preinstall dependencies (requires(pre)). Note that you must enclose # May be used to set RPM preinstall dependencies (requires(pre)). Note that
# the complete requires string between quotes, for example:: # you must enclose the complete requires string between quotes, for example::
# #
# set(CPACK_RPM_PACKAGE_REQUIRES_PRE "shadow-utils, initscripts") # set(CPACK_RPM_PACKAGE_REQUIRES_PRE "shadow-utils, initscripts")
# #
@ -279,12 +300,11 @@
# * Mandatory : NO # * Mandatory : NO
# * Default : - # * Default : -
# #
# May be used to set RPM postinstall dependencies (requires(post)). Note that you must enclose # May be used to set RPM postinstall dependencies (requires(post)). Note that
# the complete requires string between quotes, for example:: # you must enclose the complete requires string between quotes, for example::
# #
# set(CPACK_RPM_PACKAGE_REQUIRES_POST "shadow-utils, initscripts") # set(CPACK_RPM_PACKAGE_REQUIRES_POST "shadow-utils, initscripts")
# #
#
# .. variable:: CPACK_RPM_PACKAGE_REQUIRES_POSTUN # .. variable:: CPACK_RPM_PACKAGE_REQUIRES_POSTUN
# CPACK_RPM_<component>_PACKAGE_REQUIRES_POSTUN # CPACK_RPM_<component>_PACKAGE_REQUIRES_POSTUN
# #
@ -293,12 +313,12 @@
# * Mandatory : NO # * Mandatory : NO
# * Default : - # * Default : -
# #
# May be used to set RPM postuninstall dependencies (requires(postun)). Note that you must enclose # May be used to set RPM postuninstall dependencies (requires(postun)). Note
# the complete requires string between quotes, for example:: # that you must enclose the complete requires string between quotes, for
# example::
# #
# set(CPACK_RPM_PACKAGE_REQUIRES_POSTUN "shadow-utils, initscripts") # set(CPACK_RPM_PACKAGE_REQUIRES_POSTUN "shadow-utils, initscripts")
# #
#
# .. variable:: CPACK_RPM_PACKAGE_REQUIRES_PREUN # .. variable:: CPACK_RPM_PACKAGE_REQUIRES_PREUN
# CPACK_RPM_<component>_PACKAGE_REQUIRES_PREUN # CPACK_RPM_<component>_PACKAGE_REQUIRES_PREUN
# #
@ -307,8 +327,8 @@
# * Mandatory : NO # * Mandatory : NO
# * Default : - # * Default : -
# #
# May be used to set RPM preuninstall dependencies (requires(preun)). Note that you must enclose # May be used to set RPM preuninstall dependencies (requires(preun)). Note that
# the complete requires string between quotes, for example:: # you must enclose the complete requires string between quotes, for example::
# #
# set(CPACK_RPM_PACKAGE_REQUIRES_PREUN "shadow-utils, initscripts") # set(CPACK_RPM_PACKAGE_REQUIRES_PREUN "shadow-utils, initscripts")
# #
@ -360,20 +380,22 @@
# rpm --prefix or --relocate # rpm --prefix or --relocate
# #
# in order to install it at an alternate place see rpm(8). Note that # in order to install it at an alternate place see rpm(8). Note that
# currently this may fail if CPACK_SET_DESTDIR is set to ON. If # currently this may fail if :variable:`CPACK_SET_DESTDIR` is set to ``ON``. If
# CPACK_SET_DESTDIR is set then you will get a warning message but if there # :variable:`CPACK_SET_DESTDIR` is set then you will get a warning message but
# is file installed with absolute path you'll get unexpected behavior. # if there is file installed with absolute path you'll get unexpected behavior.
# #
# .. variable:: CPACK_RPM_SPEC_INSTALL_POST # .. variable:: CPACK_RPM_SPEC_INSTALL_POST
# #
# Deprecated - use :variable:`CPACK_RPM_POST_INSTALL_SCRIPT_FILE` instead.
#
# * Mandatory : NO # * Mandatory : NO
# * Default : - # * Default : -
# * Deprecated: YES # * Deprecated: YES
# #
# This way of specifying post-install script is deprecated, use # This way of specifying post-install script is deprecated, use
# CPACK_RPM_POST_INSTALL_SCRIPT_FILE. # :variable:`CPACK_RPM_POST_INSTALL_SCRIPT_FILE`.
# May be used to set an RPM post-install command inside the spec file. # May be used to set an RPM post-install command inside the spec file.
# For example setting it to "/bin/true" may be used to prevent # For example setting it to ``/bin/true`` may be used to prevent
# rpmbuild to strip binaries. # rpmbuild to strip binaries.
# #
# .. variable:: CPACK_RPM_SPEC_MORE_DEFINE # .. variable:: CPACK_RPM_SPEC_MORE_DEFINE
@ -383,7 +405,7 @@
# * Mandatory : NO # * Mandatory : NO
# * Default : - # * Default : -
# #
# May be used to add any %define lines to the generated spec file. # May be used to add any ``%define`` lines to the generated spec file.
# #
# .. variable:: CPACK_RPM_PACKAGE_DEBUG # .. variable:: CPACK_RPM_PACKAGE_DEBUG
# #
@ -398,6 +420,7 @@
# cpack -D CPACK_RPM_PACKAGE_DEBUG=1 -G RPM # cpack -D CPACK_RPM_PACKAGE_DEBUG=1 -G RPM
# #
# .. variable:: CPACK_RPM_USER_BINARY_SPECFILE # .. variable:: CPACK_RPM_USER_BINARY_SPECFILE
# CPACK_RPM_<componentName>_USER_BINARY_SPECFILE
# #
# A user provided spec file. # A user provided spec file.
# #
@ -407,8 +430,6 @@
# May be set by the user in order to specify a USER binary spec file # May be set by the user in order to specify a USER binary spec file
# to be used by CPackRPM instead of generating the file. # to be used by CPackRPM instead of generating the file.
# The specified file will be processed by configure_file( @ONLY). # The specified file will be processed by configure_file( @ONLY).
# One can provide a component specific file by setting
# CPACK_RPM_<componentName>_USER_BINARY_SPECFILE.
# #
# .. variable:: CPACK_RPM_GENERATE_USER_BINARY_SPECFILE_TEMPLATE # .. variable:: CPACK_RPM_GENERATE_USER_BINARY_SPECFILE_TEMPLATE
# #
@ -423,21 +444,24 @@
# cpack -D CPACK_RPM_GENERATE_USER_BINARY_SPECFILE_TEMPLATE=1 -G RPM # cpack -D CPACK_RPM_GENERATE_USER_BINARY_SPECFILE_TEMPLATE=1 -G RPM
# #
# The user may then use this file in order to hand-craft is own # The user may then use this file in order to hand-craft is own
# binary spec file which may be used with CPACK_RPM_USER_BINARY_SPECFILE. # binary spec file which may be used with
# :variable:`CPACK_RPM_USER_BINARY_SPECFILE`.
# #
# .. variable:: CPACK_RPM_PRE_INSTALL_SCRIPT_FILE # .. variable:: CPACK_RPM_PRE_INSTALL_SCRIPT_FILE
# CPACK_RPM_PRE_UNINSTALL_SCRIPT_FILE # CPACK_RPM_PRE_UNINSTALL_SCRIPT_FILE
# #
# Path to file containing pre (un)install script.
#
# * Mandatory : NO # * Mandatory : NO
# * Default : - # * Default : -
# #
# May be used to embed a pre (un)installation script in the spec file. # May be used to embed a pre (un)installation script in the spec file.
# The refered script file(s) will be read and directly # The referred script file (or both) will be read and directly
# put after the %pre or %preun section # put after the ``%pre`` or ``%preun`` section
# If CPACK_RPM_COMPONENT_INSTALL is set to ON the (un)install script for # If :variable:`CPACK_RPM_PACKAGE_COMPONENT` is set to ON the (un)install
# each component can be overridden with # script for each component can be overridden with
# CPACK_RPM_<COMPONENT>_PRE_INSTALL_SCRIPT_FILE and # ``CPACK_RPM_<COMPONENT>_PRE_INSTALL_SCRIPT_FILE`` and
# CPACK_RPM_<COMPONENT>_PRE_UNINSTALL_SCRIPT_FILE. # ``CPACK_RPM_<COMPONENT>_PRE_UNINSTALL_SCRIPT_FILE``.
# One may verify which scriptlet has been included with:: # One may verify which scriptlet has been included with::
# #
# rpm -qp --scripts package.rpm # rpm -qp --scripts package.rpm
@ -445,16 +469,18 @@
# .. variable:: CPACK_RPM_POST_INSTALL_SCRIPT_FILE # .. variable:: CPACK_RPM_POST_INSTALL_SCRIPT_FILE
# CPACK_RPM_POST_UNINSTALL_SCRIPT_FILE # CPACK_RPM_POST_UNINSTALL_SCRIPT_FILE
# #
# Path to file containing post (un)install script.
#
# * Mandatory : NO # * Mandatory : NO
# * Default : - # * Default : -
# #
# May be used to embed a post (un)installation script in the spec file. # May be used to embed a post (un)installation script in the spec file.
# The refered script file(s) will be read and directly # The referred script file (or both) will be read and directly
# put after the %post or %postun section. # put after the ``%post`` or ``%postun`` section.
# If CPACK_RPM_COMPONENT_INSTALL is set to ON the (un)install script for # If :variable:`CPACK_RPM_PACKAGE_COMPONENT` is set to ON the (un)install
# each component can be overridden with # script for each component can be overridden with
# CPACK_RPM_<COMPONENT>_POST_INSTALL_SCRIPT_FILE and # ``CPACK_RPM_<COMPONENT>_POST_INSTALL_SCRIPT_FILE`` and
# CPACK_RPM_<COMPONENT>_POST_UNINSTALL_SCRIPT_FILE. # ``CPACK_RPM_<COMPONENT>_POST_UNINSTALL_SCRIPT_FILE``.
# One may verify which scriptlet has been included with:: # One may verify which scriptlet has been included with::
# #
# rpm -qp --scripts package.rpm # rpm -qp --scripts package.rpm
@ -465,11 +491,11 @@
# * Mandatory : NO # * Mandatory : NO
# * Default : - # * Default : -
# #
# May be used to explicitly specify %(<directive>) file line # May be used to explicitly specify ``%(<directive>)`` file line
# in the spec file. Like %config(noreplace) or any other directive # in the spec file. Like ``%config(noreplace)`` or any other directive
# that be found in the %files section. Since CPackRPM is generating # that be found in the ``%files`` section. Since CPackRPM is generating
# the list of files (and directories) the user specified files of # the list of files (and directories) the user specified files of
# the CPACK_RPM_<COMPONENT>_USER_FILELIST list will be removed from # the ``CPACK_RPM_<COMPONENT>_USER_FILELIST`` list will be removed from
# the generated list. # the generated list.
# #
# .. variable:: CPACK_RPM_CHANGELOG_FILE # .. variable:: CPACK_RPM_CHANGELOG_FILE
@ -480,7 +506,7 @@
# * Default : - # * Default : -
# #
# May be used to embed a changelog in the spec file. # May be used to embed a changelog in the spec file.
# The refered file will be read and directly put after the %changelog # The referred file will be read and directly put after the ``%changelog``
# section. # section.
# #
# .. variable:: CPACK_RPM_EXCLUDE_FROM_AUTO_FILELIST # .. variable:: CPACK_RPM_EXCLUDE_FROM_AUTO_FILELIST
@ -495,7 +521,7 @@
# reasonable set of values if the variable is not defined by the user. If the # reasonable set of values if the variable is not defined by the user. If the
# variable is defined by the user then CPackRPM will NOT any of the default # variable is defined by the user then CPackRPM will NOT any of the default
# path. If you want to add some path to the default list then you can use # path. If you want to add some path to the default list then you can use
# CPACK_RPM_EXCLUDE_FROM_AUTO_FILELIST_ADDITION variable. # :variable:`CPACK_RPM_EXCLUDE_FROM_AUTO_FILELIST_ADDITION` variable.
# #
# .. variable:: CPACK_RPM_EXCLUDE_FROM_AUTO_FILELIST_ADDITION # .. variable:: CPACK_RPM_EXCLUDE_FROM_AUTO_FILELIST_ADDITION
# #
@ -505,39 +531,47 @@
# * Default : - # * Default : -
# #
# May be used to add more exclude path (directories or files) from the initial # May be used to add more exclude path (directories or files) from the initial
# default list of excluded paths. See CPACK_RPM_EXCLUDE_FROM_AUTO_FILELIST. # default list of excluded paths. See
# :variable:`CPACK_RPM_EXCLUDE_FROM_AUTO_FILELIST`.
# #
# .. variable:: CPACK_RPM_RELOCATION_PATHS # .. variable:: CPACK_RPM_RELOCATION_PATHS
# #
# Packages relocation paths list.
#
# * Mandatory : NO # * Mandatory : NO
# * Default : - # * Default : -
# #
# May be used to specify more than one relocation path per relocatable RPM. # May be used to specify more than one relocation path per relocatable RPM.
# Variable contains a list of relocation paths that if relative are prefixed # Variable contains a list of relocation paths that if relative are prefixed
# by the value of CPACK_RPM_<COMPONENT>_PACKAGE_PREFIX or by the value of # by the value of :variable:`CPACK_RPM_<COMPONENT>_PACKAGE_PREFIX` or by the
# CPACK_PACKAGING_INSTALL_PREFIX if the component version is not provided. # value of :variable:`CPACK_PACKAGING_INSTALL_PREFIX` if the component version
# is not provided.
# Variable is not component based as its content can be used to set a different # Variable is not component based as its content can be used to set a different
# path prefix for e.g. binary dir and documentation dir at the same time. # path prefix for e.g. binary dir and documentation dir at the same time.
# Only prefixes that are required by a certain component are added to that # Only prefixes that are required by a certain component are added to that
# component - component must contain at least one file/directory/symbolic link # component - component must contain at least one file/directory/symbolic link
# with CPACK_RPM_RELOCATION_PATHS prefix for a certain relocation path # with :variable:`CPACK_RPM_RELOCATION_PATHS` prefix for a certain relocation
# to be added. Package will not contain any relocation paths if there are no # path to be added. Package will not contain any relocation paths if there are
# files/directories/symbolic links on any of the provided prefix locations. # no files/directories/symbolic links on any of the provided prefix locations.
# Packages that either do not contain any relocation paths or contain # Packages that either do not contain any relocation paths or contain
# files/directories/symbolic links that are outside relocation paths print # files/directories/symbolic links that are outside relocation paths print
# out an AUTHOR_WARNING that RPM will be partially relocatable. # out an ``AUTHOR_WARNING`` that RPM will be partially relocatable.
# #
# .. variable:: CPACK_RPM_<COMPONENT>_PACKAGE_PREFIX # .. variable:: CPACK_RPM_<COMPONENT>_PACKAGE_PREFIX
# #
# Per component relocation path install prefix.
#
# * Mandatory : NO # * Mandatory : NO
# * Default : CPACK_PACKAGING_INSTALL_PREFIX # * Default : CPACK_PACKAGING_INSTALL_PREFIX
# #
# May be used to set per component CPACK_PACKAGING_INSTALL_PREFIX for # May be used to set per component :variable:`CPACK_PACKAGING_INSTALL_PREFIX`
# relocatable RPM packages. # for relocatable RPM packages.
# #
# .. variable:: CPACK_RPM_NO_INSTALL_PREFIX_RELOCATION # .. variable:: CPACK_RPM_NO_INSTALL_PREFIX_RELOCATION
# CPACK_RPM_NO_<COMPONENT>_INSTALL_PREFIX_RELOCATION # CPACK_RPM_NO_<COMPONENT>_INSTALL_PREFIX_RELOCATION
# #
# Removal of default install prefix from relocation paths list.
#
# * Mandatory : NO # * Mandatory : NO
# * Default : CPACK_PACKAGING_INSTALL_PREFIX or CPACK_RPM_<COMPONENT>_PACKAGE_PREFIX # * Default : CPACK_PACKAGING_INSTALL_PREFIX or CPACK_RPM_<COMPONENT>_PACKAGE_PREFIX
# are treated as one of relocation paths # are treated as one of relocation paths
@ -602,9 +636,19 @@
# * Mandatory : NO # * Mandatory : NO
# * Default : - (system default) # * Default : - (system default)
# #
# Accepted values are lists with PERMISSIONS. Valid permissions # Accepted values are lists with ``PERMISSIONS``. Valid permissions
# are OWNER_READ, OWNER_WRITE, OWNER_EXECUTE, GROUP_READ, # are:
# GROUP_WRITE, GROUP_EXECUTE, WORLD_READ, WORLD_WRITE and WORLD_EXECUTE. #
# - OWNER_READ
# - OWNER_WRITE
# - OWNER_EXECUTE
# - GROUP_READ
# - GROUP_WRITE
# - GROUP_EXECUTE
# - WORLD_READ
# - WORLD_WRITE
# - WORLD_EXECUTE
#
# Note that <compName> must be in upper-case. # Note that <compName> must be in upper-case.
# #
# .. variable:: CPACK_RPM_DEFAULT_DIR_PERMISSIONS # .. variable:: CPACK_RPM_DEFAULT_DIR_PERMISSIONS
@ -616,8 +660,7 @@
# * Default : - (system default) # * Default : - (system default)
# #
# Accepted values are lists with PERMISSIONS. Valid permissions # Accepted values are lists with PERMISSIONS. Valid permissions
# are OWNER_READ, OWNER_WRITE, OWNER_EXECUTE, GROUP_READ, # are the same as for :variable:`CPACK_RPM_DEFAULT_FILE_PERMISSIONS`.
# GROUP_WRITE, GROUP_EXECUTE, WORLD_READ, WORLD_WRITE and WORLD_EXECUTE.
# Note that <compName> must be in upper-case. # Note that <compName> must be in upper-case.
# #
# Packaging of Symbolic Links # Packaging of Symbolic Links
@ -643,7 +686,7 @@
# Symbolic links that point to locations outside packaging path produce a # Symbolic links that point to locations outside packaging path produce a
# warning and are treated as non relocatable permanent symbolic links. # warning and are treated as non relocatable permanent symbolic links.
# #
# Currenty there are a few limitations though: # Currently there are a few limitations though:
# #
# * For component based packaging component interdependency is not checked # * For component based packaging component interdependency is not checked
# when processing symbolic links. Symbolic links pointing to content of # when processing symbolic links. Symbolic links pointing to content of