Skip to contentSkip to conversation

ref-manual: Add documentation of PACKAGE_DEBUG_FILE_SUFFIX

PATCH In review Peter Kjellerstedt 3 participants 4 messages Jan 7, 2022 – Jan 10, 2022

lore
Share & tools
lore
#0 lore raw

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

---

PATCHv2: Removed the reference to split_and_strip_files().
PATCHv3: Changed "dbg package" to "``-dbg`` package".

 documentation/ref-manual/variables.rst | 8 ++++++++
 1 file changed, 8 insertions(+)
documentation/ref-manual/variables.rst +8 -0
index e81a12030a..aaba23dbdf 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 that go
+      into the ``-dbg`` package. 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
Reviewed-by on v3 1/1
#1 lore raw
Quoted 18 lines · Peter Kjellerstedt

---

PATCHv2: Removed the reference to split_and_strip_files().
PATCHv3: Changed "dbg package" to "``-dbg`` package".

 documentation/ref-manual/variables.rst | 8 ++++++++
 1 file changed, 8 insertions(+)
documentation/ref-manual/variables.rst +1 -0
index e81a12030a..aaba23dbdf 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`

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

Quoted 10 lines
documentation/ref-manual/variables.rst +7 -0
+      This suffix is added to the names of all files with debug symbols that go
+      into the ``-dbg`` package. 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

... and merged into "master-next".

Thanks for the patch!
Michael.

Signature · 3 lines
Michael Opdenacker, Bootlin
Embedded Linux and Kernel engineering
https://bootlin.com
#2 lore raw
Quoted 37 lines

-----Original Message-----
From: Michael Opdenacker <[email protected]>
Sent: den 10 januari 2022 15:39
To: Peter Kjellerstedt <[email protected]>; [email protected]
Subject: Re: [docs] [PATCHv3] ref-manual: Add documentation of PACKAGE_DEBUG_FILE_SUFFIX

Quoted 18 lines · Peter Kjellerstedt

---

PATCHv2: Removed the reference to split_and_strip_files().
PATCHv3: Changed "dbg package" to "``-dbg`` package".

 documentation/ref-manual/variables.rst | 8 ++++++++
 1 file changed, 8 insertions(+)
documentation/ref-manual/variables.rst +1 -0
index e81a12030a..aaba23dbdf 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`

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

Quoted 10 lines
documentation/ref-manual/variables.rst +7 -0
+      This suffix is added to the names of all files with debug symbols that go
+      into the ``-dbg`` package. 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
Quoted 4 lines

... and merged into "master-next".

Thanks for the patch!
Michael.

Just be aware that it still hasn't made it into meta...

//Peter

#3 lore raw
Quoted 2 lines · Peter Kjellerstedt

Just be aware that it still hasn't made it into meta...

Oops, I removed it from master-next then.
Just keep me posted when the corresponding patch is merged. Thanks
Michael.

Signature · 3 lines
Michael Opdenacker, Bootlin
Embedded Linux and Kernel engineering
https://bootlin.com