Bug 9899

Summary:	Add REMOVE_PKG_SUPPORT to variable reference
Product:	[Documentation] Reference	Reporter:	Stephano Cetola <stephano>
Component:	handbook	Assignee:	Scott Rifenbark <srifenbark>
Status:	RESOLVED FIXED	QA Contact:
Severity:	enhancement
Priority:	Medium	CC:	poky.doc.watcher, poky.watcher, ross.burton, sgw, srifenbark, stephano
Version:	2.1
Target Milestone:	2.2 M3
Hardware:	All
OS:	Multiple
Whiteboard:	01 Sept 2016: RESOLVED
OS type for building Yocto:	---	Type of Regression:	---
Verified:		Documentation change:	Done (doc changes complete)
Bug Depends on:	9491
Bug Blocks:

Description Stephano Cetola 2016-07-08 16:24:01 UTC

We will need to add a new variable to the list for an added feature:

REMOVE_PKG_SUPPORT

For images not containing a package manager, this allows the removal of supporting packages. Packages that will be uninstalled include: update-rc.d, base-passwd, shadow and update-alternatives.

Set the variable to "1" to remove these packages.

Comment 1 Stephano Cetola 2016-07-08 16:33:59 UTC

Sorry, I missed one package from that list. The list should be:

update-rc.d, base-passwd, shadow, run-postinsts, and update-alternatives.

Comment 2 Scott Rifenbark 2016-07-12 19:33:18 UTC

Hi, 

See http://www.yoctoproject.org/docs/2.2/ref-manual/ref-manual.html#var-REMOVE_PKG_SUPPORT for the new entry in the glossary.  Let me know if this is okay. 

Thanks,
Scott

Comment 3 Stephano Cetola 2016-07-12 21:03:18 UTC

Looks great!  Thanks Scott.

Comment 4 Scott Rifenbark 2016-07-12 21:14:23 UTC

Thanks Stephano, 

Bug 9491 is blocking this so I won't change the status at this point.

Scott

Comment 5 Stephano Cetola 2016-07-12 23:05:34 UTC

Hey Scott,

Actually, do hold off on this. I just had a meeting regarding 9491 and we're going to be changing the name and probably the text of this as well.

I'll send over the changes when they are ready.

Stephano

Comment 6 Ross Burton 2016-07-20 13:48:12 UTC

Scott - can you revert this commit (95b740d719a7a6ffe3a06a1f152af4d877ee08c7) so the documentation doesn't talk about variables that don't exist?

Comment 7 Scott Rifenbark 2016-07-21 18:15:57 UTC

Ross, 

Sorry about that... I jumped the gun on this one.  I will revert it.  See http://git.yoctoproject.org/cgit/cgit.cgi/yocto-docs/commit/?id=094ea24b03f92594e6e5d145b58c49ef5d8edfd7.

Scott

Comment 8 Stephano Cetola 2016-08-26 16:12:50 UTC

This is ready to go now. The variable name / description is as follows:

FORCE_RO_REMOVE
Setting this variable to "1" will force the removal of the packages listed in ROOTFS_RO_UNNEEDED during the generation of the rootfs.

Comment 9 Scott Rifenbark 2016-09-01 20:03:27 UTC

Hi, 

See http://www.yoctoproject.org/docs/2.2/ref-manual/ref-manual.html#var-FORCE_RO_REMOVE for the new variable description.  

Note that this variable description introduces the ROOTFS_RO_UNNEEDED variable, which is not in the manual.  Do we want to document that variable as well in the glossary?  If so, can you provide a baseline description of it for me?  If you provide a description, could you also provide a use-case example that I could use in the entry?

Thanks,
Scott

Comment 10 Stephano Cetola 2016-09-01 21:01:20 UTC

ROOTFS_RO_UNNEEDED cannot be easily overwritten by the end user and we don't want to give them the impression that it is something they should be editing if they want to remove packages. That could be both dangerous and confusing. Also since the contents of that list can change with each new release, it would be a pain to have to keep that up to date.

I say leave it out of the manual and see if anyone complains. I doubt they will.

Comment 11 Scott Rifenbark 2016-09-01 21:30:19 UTC

Perfect.. thanks.

How does the description look to you otherwise?

Scott

Comment 12 Stephano Cetola 2016-09-01 21:33:21 UTC

Yep, looks perfect.

Comment 13 Scott Rifenbark 2016-09-01 21:51:54 UTC

Thanks, 

I am setting the bug to RESOLVED and putting the doc flag to "done."

Scott