Bug 9983

Summary:	host-user-contaminated, invalid-chars, and invalid-packageconfig are missing from '7.62. insane.bbclass'
Product:	[Documentation] Reference	Reporter:	ulfalizer
Component:	handbook	Assignee:	Scott Rifenbark <srifenbark>
Status:	RESOLVED FIXED	QA Contact:
Severity:	enhancement
Priority:	Undecided	CC:	bluelightning, poky.doc.watcher, poky.watcher, srifenbark
Version:	2.2
Target Milestone:	2.2 M3
Hardware:	x86
OS:	Multiple
Whiteboard:	19 July 2016: RESOLVED
OS type for building Yocto:	---	Type of Regression:	---
Verified:		Documentation change:	Done (doc changes complete)

Description ulfalizer 2016-07-19 19:42:21 UTC

Here's some suggested descriptions. I checked the implementations in
insane.bbclass.

 * host-user-contaminated: Checks that no package produced by the
   recipe contains any files outside of /home with a user or group ID that
   matches the user running BitBake. A match usually indicates that the files
   are being installed with an incorrect UID/GID, since target IDs are
   independent from host IDs. See also the description of the
   (do_install)[http://www.yoctoproject.org/docs/2.2/ref-manual/ref-manual.html#ref-tasks-install]
   task.

 * invalid-chars: Checks that the recipe metadata variables DESCRIPTION, SUMMARY,
   LICENSE, and SECTION do not contain non-UTF-8 characters. Some package
   managers do not support such characters.

 * invalid-packageconfig: Checks that no undefined features are being added to
   PACKAGECONFIG, i.e. any name "foo" for which there is no

     PACKACONFIG[foo] = "..."

Cheers,
Ulf

Comment 1 ulfalizer 2016-07-19 19:44:30 UTC

Ops... typo.

  PACKACONFIG[foo] = "..."

should have been

  PACKAGECONFIG[foo] = "..."

Comment 2 Scott Rifenbark 2016-07-19 20:54:09 UTC

Hi Ulf, 

Added host-user-contaminated.  Also, put a link from the do_install task description back into the insane.bbclass seciton since that host-user-contaminated is referenced there as well - http://www.yoctoproject.org/docs/2.2/ref-manual/ref-manual.html#ref-tasks-install

Added both invalid-chars and invalid-packageconfig to the list as well.  See http://www.yoctoproject.org/docs/2.2/ref-manual/ref-manual.html#ref-classes-insane for these and the previous.

Thanks, 
Scott

Comment 3 ulfalizer 2016-07-19 21:07:16 UTC

Looks like there's an extra comma in "...and SECTION, do not..." in the description of invalid-chars. Looks fine to me otherwise.

Thanks,
Ulf

Comment 4 Scott Rifenbark 2016-07-19 21:18:11 UTC

Yep - that is what cutting and pasting long cross-reference code links will do to you :)

Fixed - http://www.yoctoproject.org/docs/2.2/ref-manual/ref-manual.html#ref-classes-insane

I am closing up the bug.

Thanks, 
Scott