Bug 6621 - Document debug-without-src
Summary: Document debug-without-src
Status: RESOLVED FIXED
Alias: None
Product: Reference
Classification: Documentation
Component: handbook (show other bugs)
Version: unspecified
Hardware: x86 Multiple
: Medium enhancement
Target Milestone: 1.7
Assignee: Scott Rifenbark
QA Contact:
URL:
Whiteboard: 15 August 2014: RESOLVED
Depends on:
Blocks:
 
Reported: 2014-08-11 09:43 UTC by Laszlo Papp
Modified: 2014-08-15 05:50 UTC (History)
4 users (show)

See Also:
OS type for building Yocto: ---
Type of Regression: ---
Verified:
Documentation change: Done (doc changes complete)


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Laszlo Papp 2014-08-11 09:43:12 UTC
I was looking for an option like this because we use gdbserver on the target as opposed to the full-blown gdb due to space constraints. As such, we do not need the source files shipped by the default foo-dbg packages. There seems to be an option for this, but it is not documented. It would be nice to make a brief note on it. Here is the commit that introduced the change:

http://lists.openembedded.org/pipermail/openembedded-core/2013-March/075836.html

I am not sure where to add it in the manual (probably debugging section and/or package.class?). Either way, the content is simple: if one specifies this as PACKAGE_DEBUG_SPLIT_STYLE = 'debug-without-src', the source files will not be added to the foo-dbg package for installation. This is useful when using gdbserver due to space constraints (e.g. desperately small flash size).
Comment 1 Scott Rifenbark 2014-08-13 13:32:26 UTC
Hi, 

I have made some additions to the dev-manual and the ref-manual to handle this issue.  In the ref-manual, I created a new variable entry for PACKAGE_DEBUG_SPLIT_STYLE.  In the dev-manual I added a note in the area that talks about saving space to point out that you can save more space by excluding the source and then referenced into the variable.

Here are the sections:

http://www.yoctoproject.org/docs/1.7/ref-manual/ref-manual.html#var-PACKAGE_DEBUG_SPLIT_STYLE

http://www.yoctoproject.org/docs/1.7/dev-manual/dev-manual.html#platdev-gdb-remotedebug

Please check them out and let me know of any issues.

Thanks,
Scott
Comment 2 Laszlo Papp 2014-08-13 13:47:37 UTC
Cool, thanks!
Comment 3 Scott Rifenbark 2014-08-15 05:50:20 UTC
Thanks Laszlo.

Marking RESOLVED and setting doc flag to "Done."

Scott