ref-manual: add glossary entry, INHIBIT_PACKAGE_STRIP_FILES

Submitted by Robert P. J. Day on May 21, 2021, 9:04 a.m. | Patch ID: 179744

Details

Message ID e93fc77b-ea2f-862c-1476-6716da65e47f@crashcourse.ca
State New
Headers show

Commit Message

Robert P. J. Day May 21, 2021, 9:04 a.m.
Signed-off-by: Robert P. J. Day <rpjday@crashcourse.ca>

---

Patch hide | download patch | download mbox

diff --git a/documentation/ref-manual/variables.rst b/documentation/ref-manual/variables.rst
index 0b61f77cb..b1774d22a 100644
--- a/documentation/ref-manual/variables.rst
+++ b/documentation/ref-manual/variables.rst
@@ -3446,6 +3446,16 @@  system and gives an overview of their function and contents.
       Consequently, you should not set ``INHIBIT_PACKAGE_STRIP`` when you
       plan to debug in general.

+   :term:`INHIBIT_PACKAGE_STRIP_FILES`
+      List of files to avoid stripping, to retain the ability to run
+      certain tests on them. A small example from current ``elfutils``
+      recipe file::
+
+         INHIBIT_PACKAGE_STRIP_FILES = "\
+             ${PKGD}${PTEST_PATH}/tests/test-nlist \
+             ${PKGD}${PTEST_PATH}/tests/elfstrmerge \
+             ... snip ...
+
    :term:`INHIBIT_SYSROOT_STRIP`
       If set to "1", causes the build to not strip binaries in the
       resulting sysroot.