Kitware/CMake
1
0
Fork 0
mirror of https://github.com/Kitware/CMake.git synced 2025-10-21 14:40:48 +08:00
Code Issues Projects Releases Wiki Activity

CPack/DEB+RPM: Update documentation on debug symbol package creation

Browse Source 
Update documentation to elaborate on the behavior between `.ddeb` creation,
CPACK_STRIP_FILES, and if the files are actually stripped.

Closes: #22438
This commit is contained in:
Russell Greene
2021-07-26 14:31:26 -04:00
parent 6c01bbe180
commit 008d55df76
2 changed files with 13 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

9
Help/cpack_gen/deb.rst
View File

@@ -650,11 +650,20 @@ Dbgsym packaging has its own set of variables:
* Mandatory : NO * Mandatory : NO
* Default : OFF * Default : OFF
.. 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:: .. note::
Binaries must contain debug symbols before packaging so use either ``Debug`` Binaries must contain debug symbols before packaging so use either ``Debug``
or ``RelWithDebInfo`` for :variable:`CMAKE_BUILD_TYPE` variable value. 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 Building Debian packages on Windows
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

4
Help/cpack_gen/rpm.rst
View File

@@ -840,6 +840,10 @@ Debuginfo RPM packaging has its own set of variables:
Binaries must contain debug symbols before packaging so use either ``Debug`` Binaries must contain debug symbols before packaging so use either ``Debug``
or ``RelWithDebInfo`` for :variable:`CMAKE_BUILD_TYPE` variable value. 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:: .. note::
Packages generated from packages without binary files, with binary files but Packages generated from packages without binary files, with binary files but