Bug 538254

Summary:	<=sys-apps/portage-2.2.14 CPU_FLAGS_X86 not documented in manpage
Product:	Portage Development	Reporter:	Tim Mohlmann <muhlemmer>
Component:	Documentation	Assignee:	Portage team <dev-portage>
Status:	RESOLVED INVALID
Severity:	minor	CC:	floppym
Priority:	Normal
Version:	unspecified
Hardware:	All
OS:	Linux
Whiteboard:
Package list:		Runtime testing required:	---

Description Tim Mohlmann 2015-01-30 16:16:29 UTC

The new CPU_FLAGS_X86 introduced in portage is not documented in man page.

It is only documented in the portage news item "2015-01-28-cpu_flags_x86-introduction". I think it should also be in the make.conf manpage?

Reproducible: Always

Steps to Reproduce:
1.emerge --sync
2.Update portage to latest stable
3.man make.conf
Actual Results:  
No section called CPU_FLAGS_X86

Expected Results:  
A section called CPU_FLAGS_X86, explaining more or less the same thing as the news item.

Comment 1 Mike Gilbert gentoo-dev

2015-01-30 17:27:58 UTC

Do we document any other USE_EXPAND variables in this manner?

Comment 2 Tim Mohlmann 2015-01-30 18:20:57 UTC

Aha, got your point. They are not. Sorry to bother.

Was just, I see all these unexpected changes during a world update. I start looking in the man pages, found nothing. Then I remembered myself: maybe read those news items I always ignore and there I found the answer.

It never occurred to me that USE_EXPAND variables are not documented in man pages.

Comment 3 Brian Dolbec (RETIRED) gentoo-dev

2015-01-30 18:31:41 UTC

Also...

How can it be a bug for these portage releases because it doesn't document something from another package that was created and released after it was.

Portage's code and man pages can not be psycic and predict future changes.