Bug 9580

Summary: Missing package dependency in quick start guide for Fedora
Product: [Documentation] Quick Start Reporter: Henry Bruce <henry.bruce>
Component: quick-startAssignee: Scott Rifenbark <srifenbark>
Status: RESOLVED FIXED QA Contact:
Severity: normal    
Priority: Medium CC: bluelightning, poky.doc.watcher, poky.watcher, ross.burton, srifenbark, tim.orling
Version: 2.0.2   
Target Milestone: 2.2 M4   
Hardware: x86   
OS: Multiple   
Whiteboard: 01 Sept 2016: RESOLVED
OS type for building Yocto: --- Type of Regression: ---
Verified: Documentation change: Done (doc changes complete)

Description Henry Bruce 2016-05-03 21:25:23 UTC 
perl-bignum package is required to build core-image-minimal with qemux86 machine but is not a required package in quick start guide.

Host OS is Fedora23 64 bit.

Expected behavior
------------------
Follow quick start guide and image builds.

Observed behavior
-----------------
Follow quick start guide and build fails as follows
ERROR: The perl module 'bignum' was not found but this is required to build openssl.  Please install this module (often packaged as perl-bignum) and re-run bitbake.
Comment 1 Paul Eggleton 2016-05-04 05:13:25 UTC 
The Fedora package list in the 2.1 quick start guide already include perl-bignum - were you perhaps looking at the "current" manual link before that got updated (just yesterday, a bit later than it should have been)?
Comment 2 Henry Bruce 2016-05-04 06:52:04 UTC 
I was looking at http://www.yoctoproject.org/docs/2.0.1/yocto-project-qs/yocto-project-qs.html, thus the 2.0.x version tag.

There is not 2.0.1 tag, but I guess that's a different defect :-)
Comment 3 Paul Eggleton 2016-05-04 08:37:37 UTC 
As I recall this package only appeared in F23 and F23 wasn't supported by 2.0 - Ross is that right?
Comment 4 Paul Eggleton 2016-05-04 08:38:24 UTC 
(Though one would assume we would look to support it in the next 2.0 point release, so I'm not really questioning the validity of the report)
Comment 5 Ross Burton 2016-05-04 20:19:25 UTC 
Yeah its a F23 specific package from what I can remember.
Comment 6 Ross Burton 2016-05-06 11:18:34 UTC 
Scott, can we add a note to the 2.0 documentation?  Something along the lines that the 2.0 isn't supported under F23 but if you want to use it then the user has to install perl-bignum too.
Comment 7 Scott Rifenbark 2016-06-06 21:11:48 UTC 
Ross and Paul, 

I am not quite sure where we are in the latest 2.0.x release.  I have a 2.0.2 version of the manuals and I placed this note here about not supporting F23 and if you want to use it you need that package.  

It is a pain in the ass but I could fix the 2.0 and 2.0.1 versions of the QS to have the note as well.  However, only the HTML version on the YP site would have the fix.  I can't do a commit since 2.0, 2.0.1, and 2.0.2 are all on the same 'jethro' branch.  

Is that good enough?  Here is the new note:

http://www.yoctoproject.org/docs/2.0.2/yocto-project-qs/yocto-project-qs.html#packages

Scott
Comment 8 Scott Rifenbark 2016-06-27 18:00:31 UTC 
Please review this change and let me know if we can RESOLVE it in the status. 

Thanks, 
Scott
Comment 9 Tim Orling 2016-09-01 22:30:54 UTC 
this aspect at least is RESOLVED
Comment 10 Scott Rifenbark 2016-09-01 22:59:39 UTC 
Tim, 

Thanks - I set the doc flag to "done."

Scott