Bug 8986 - BB_CURRENTTASK is not listed in the reference manual
Summary: BB_CURRENTTASK is not listed in the reference manual
Status: VERIFIED NOTABUG
Alias: None
Product: Reference
Classification: Documentation
Component: handbook (show other bugs)
Version: unspecified
Hardware: x86 Multiple
: Medium enhancement
Target Milestone: 2.1
Assignee: Paul Eggleton
QA Contact: Bogdan Alexandru Voiculescu
URL:
Whiteboard:
Depends on:
Blocks:
 
Reported: 2016-01-22 17:33 UTC by Mariano Lopez
Modified: 2016-03-14 10:35 UTC (History)
5 users (show)

See Also:
OS type for building Yocto: ---
Type of Regression: ---
Verified:
Documentation change: No (bug/feature does not impact docs)

Attachments
Add an attachment (proposed patch, testcase, etc.)

Note You need to log in before you can comment on or make changes to this bug.
Description Mariano Lopez 2016-01-22 17:33:06 UTC 
BB_CURRENTTASK entry is missing in the reference manual.

This var list the task bitbake's worker is currently running

I checked in latest, 2.0 and 1.8 reference manuals.
Comment 1 Scott Rifenbark 2016-01-28 00:03:32 UTC 
Hi, 

This might be one of those variables that is documented only in the BitBake User Manual.  That manual has a glossary section similar to the YP Reference Manual.  BB_CURRENTTASK is currently documented in the BitBake Manual.  Do we want this in the YP Reference Manual?

Added Paul Eggleton to the list as he has been the one to pretty much clarify these issues.

Thanks, 
Scott
Comment 2 Scott Rifenbark 2016-02-05 23:19:39 UTC 
Changing to NEEDINFO.  I can't proceed on this until I get some clarification on Comment 1.
Comment 3 Mariano Lopez 2016-02-09 00:37:15 UTC 
Paul,

Can you help us to clarify this? Please check comment 1.

Thaks
Comment 4 Paul Eggleton 2016-02-09 00:56:18 UTC 
The question is do people who read the main reference manual need to know about all the variables bitbake intrinsically supports? I had assumed that putting the less commonly used ones in the BitBake manual only would be sufficient - some of them are frankly pretty esoteric. BB_CURRENTTASK isn't something that most people writing metadata for the system will need to use, and if they do the BB_ prefix is a subtle hint that it's a variable that BitBake itself knows about.

If you want to duplicate all of them in the reference manual then BB_CURRENTTASK is not the only one you will need to copy over.
Comment 5 Mariano Lopez 2016-02-09 01:12:59 UTC 
So, better leave the reference manual without this entry. Closing as not a bug.
Comment 6 Scott Rifenbark 2016-02-15 16:41:35 UTC 
Setting the doc flag to "No"

Scott
Comment 7 Bogdan Alexandru Voiculescu 2016-03-14 10:35:09 UTC 
Verified: there is no need for this info in other places than in BB manual.