summaryrefslogtreecommitdiffstats
path: root/Help/cpack_gen
diff options
context:
space:
mode:
authorBrad King <brad.king@kitware.com>2021-08-02 19:11:55 (GMT)
committerKitware Robot <kwrobot@kitware.com>2021-08-02 19:12:09 (GMT)
commite2fe042bad22b39eb42ea5b67cbc2c88aae2f5be (patch)
tree36800db9d87ccf18b50035eb708a18e546a26065 /Help/cpack_gen
parent0660dc4dcfc1934757a5a7f0ddf5980fee2f8d1a (diff)
parent008d55df7677ec69254cd480329dd713d103b20f (diff)
downloadCMake-e2fe042bad22b39eb42ea5b67cbc2c88aae2f5be.zip
CMake-e2fe042bad22b39eb42ea5b67cbc2c88aae2f5be.tar.gz
CMake-e2fe042bad22b39eb42ea5b67cbc2c88aae2f5be.tar.bz2
Merge topic 'cpack_debug_doc'
008d55df76 CPack/DEB+RPM: Update documentation on debug symbol package creation Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !6393
Diffstat (limited to 'Help/cpack_gen')
-rw-r--r--Help/cpack_gen/deb.rst9
-rw-r--r--Help/cpack_gen/rpm.rst4
2 files changed, 13 insertions, 0 deletions
diff --git a/Help/cpack_gen/deb.rst b/Help/cpack_gen/deb.rst
index d8d53ec..c0d9c3d 100644
--- a/Help/cpack_gen/deb.rst
+++ b/Help/cpack_gen/deb.rst
@@ -652,9 +652,18 @@ Dbgsym packaging has its own set of variables:
.. note::
+ Setting this also strips the ELF files in the generated non-dbgsym package,
+ which results in debuginfo only being available in the dbgsym package.
+
+.. note::
+
Binaries must contain debug symbols before packaging so use either ``Debug``
or ``RelWithDebInfo`` for :variable:`CMAKE_BUILD_TYPE` variable value.
+ Additionally, if :variable:`CPACK_STRIP_FILES` is set, the files will be stripped before
+ they get to the DEB generator, so will not contain debug symbols and
+ a dbgsym package will not get built. Do not use with :variable:`CPACK_STRIP_FILES`.
+
Building Debian packages on Windows
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
diff --git a/Help/cpack_gen/rpm.rst b/Help/cpack_gen/rpm.rst
index f6274f9..823594a 100644
--- a/Help/cpack_gen/rpm.rst
+++ b/Help/cpack_gen/rpm.rst
@@ -840,6 +840,10 @@ Debuginfo RPM packaging has its own set of variables:
Binaries must contain debug symbols before packaging so use either ``Debug``
or ``RelWithDebInfo`` for :variable:`CMAKE_BUILD_TYPE` variable value.
+ Additionally, if :variable:`CPACK_STRIP_FILES` is set, the files will be stripped before
+ they get to the RPM generator, so will not contain debug symbols and
+ a debuginfo package will not get built. Do not use with :variable:`CPACK_STRIP_FILES`.
+
.. note::
Packages generated from packages without binary files, with binary files but