Skip to contentSkip to conversation

ref-manual: Add documentation of PACKAGE_DEBUG_FILE_SUFFIX

PATCH Superseded Peter Kjellerstedt 2 participants 2 messages Dec 23, 2021

v1 of 3 Superseded Latest is v3 →

lore
Share & tools
lore
#0 lore raw

PATCH 1/1 ref-manual: Add documentation of PACKAGE_DEBUG_FILE_SUFFIX

---

This of course assumes that the corresponding change to OE-Core is accepted.

 documentation/ref-manual/variables.rst | 8 ++++++++
 1 file changed, 8 insertions(+)
documentation/ref-manual/variables.rst +8 -0
index e5216b3f36..52adcf1e4f 100644
@@ -5085,6 +5085,14 @@ system and gives an overview of their function and contents.
       result of the package manager in use, see the
       ":ref:`package.bbclass <ref-classes-package>`" section.
 
+   :term:`PACKAGE_DEBUG_FILE_SUFFIX`
+      This suffix is added to the names of all files with debug symbols produced
+      by split_and_strip_files(). It can be used to make the debug files
+      produced by one recipe unique to avoid them conflicting with identically
+      named debug files produced by another recipe. This may be needed since
+      while the target files may be split in multiple packages, the debug
+      files for one recipe are all in one package.
+
    :term:`PACKAGE_DEBUG_SPLIT_STYLE`
       Determines how to split up and package debug and source information
       when creating debugging packages to be used with the GNU Project
#1 lore raw

Hi Peter,

Quoted 14 lines · Peter Kjellerstedt

---

This of course assumes that the corresponding change to OE-Core is accepted.

documentation/ref-manual/variables.rst | 8 ++++++++

1 file changed, 8 insertions(+)
documentation/ref-manual/variables.rst +0 -0
index e5216b3f36..52adcf1e4f 100644

documentation/ref-manual/variables.rst system and gives an overview of their function and contents. · line 5090

Quoted 6 lines
documentation/ref-manual/variables.rst +3 -0
@@ -5085,6 +5085,14 @@ system and gives an overview of their function and contents.
      result of the package manager in use, see the
      ":ref:`package.bbclass <ref-classes-package>`" section.
 
+   :term:`PACKAGE_DEBUG_FILE_SUFFIX`
+      This suffix is added to the names of all files with debug symbols produced
+      by split_and_strip_files(). It can be used to make the debug files

I don't think we care in the documentation about the name of the function in which this variable is used. The rest looks fine.

Cheers,
Quentin

Quoted 8 lines
documentation/ref-manual/variables.rst +5 -0
+      produced by one recipe unique to avoid them conflicting with identically
+      named debug files produced by another recipe. This may be needed since
+      while the target files may be split in multiple packages, the debug
+      files for one recipe are all in one package.
+
   :term:`PACKAGE_DEBUG_SPLIT_STYLE`
      Determines how to split up and package debug and source information
      when creating debugging packages to be used with the GNU Project