Bug 8986

Summary:	BB_CURRENTTASK is not listed in the reference manual
Product:	[Documentation] Reference	Reporter:	Mariano Lopez <mariano.lopez>
Component:	handbook	Assignee:	Paul Eggleton <bluelightning>
Status:	VERIFIED NOTABUG	QA Contact:	Bogdan Alexandru Voiculescu <bogdanx.a.voiculescu>
Severity:	enhancement
Priority:	Medium	CC:	bluelightning, bogdanx.a.voiculescu, poky.doc.watcher, poky.watcher, srifenbark
Version:	unspecified
Target Milestone:	2.1
Hardware:	x86
OS:	Multiple
Whiteboard:
OS type for building Yocto:	---	Type of Regression:	---
Verified:		Documentation change:	No (bug/feature does not impact docs)

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.