Bug 423279

Summary:	Handbook refers to deprecated file use.local.desc, please explain how to find/view metadata.xml
Product:	[OLD] Docs on www.gentoo.org	Reporter:	Antonio Regidor Garcia <a_regidor>
Component:	Installation Handbook	Assignee:	Docs Team <docs-team>
Status:	RESOLVED INVALID
Severity:	normal
Priority:	Normal
Version:	unspecified
Hardware:	All
OS:	Linux
URL:	http://www.gentoo.org/doc/en/handbook/handbook-amd64.xml?part=2&chap=2
Whiteboard:
Package list:		Runtime testing required:	---

Description Antonio Regidor Garcia 2012-06-24 08:37:02 UTC

In several parts of the handbook, when explaining local USE flags, the user is referred to /usr/portage/profiles/use.local.desc to search for the explanation of what a particular local flag does. But this file says:

# This file is deprecated as per GLEP 56 in favor of metadata.xml. Please add
# your descriptions to your package's metadata.xml ONLY.

Please add some explanation to the handbook about where to find metadata.xml or which command to use to view it.

Reproducible: Always

Comment 1 Antonio Regidor Garcia 2012-06-24 13:11:34 UTC

I think I misunderstood how use.local.desc is supposed to be used. It's deprecated for developers, but not for users.