Bug 199527

Summary:	Deprecated use of 'emerge --help config'
Product:	[OLD] Docs on www.gentoo.org	Reporter:	Tobias Heinlein (RETIRED) <keytoaster>
Component:	Installation Handbook	Assignee:	nm (RETIRED) <nightmorph>
Status:	RESOLVED FIXED
Severity:	normal	CC:	dev-portage, docs-team
Priority:	High
Version:	unspecified
Hardware:	All
OS:	Linux
URL:	http://www.gentoo.org/doc/en/handbook/handbook-x86.xml?part=3&chap=2#doc_chap3
Whiteboard:
Package list:		Runtime testing required:	---

Description Tobias Heinlein (RETIRED) gentoo-dev

2007-11-18 14:01:09 UTC

Simon Linden just informed me via mail that the handbook (see URL field) tells the user to run "emerge --help config" to get more information about Portage's Configuration File Protection. However, this apparently is not right anymore with regards to bug 137483.

$ emerge --help config
*** Deprecated use of action 'config', use '--config' instead
$ emerge --help --config
$

Comment 1 nm (RETIRED) gentoo-dev

2007-11-18 22:50:17 UTC

The warning does pop up when running the old 'emerge --help config', but nothing happens when I run 'emerge --help --config', so I don't think that's a solution, either. And yes, even though the man page says that --help should work for options like --config, it doesn't work for that one. (stable 2.1.3.19)

CCing the Portage guys to figure out what to do for this one.

Comment 2 Zac Medico gentoo-dev

2007-11-19 07:03:36 UTC

We moved those docs into the "CONFIGURATION FILES" section of the emerge.1 manpage, so it should tell them to run `man emerge` instead of `emerge --help config`.

Comment 3 nm (RETIRED) gentoo-dev

2007-11-19 07:45:37 UTC

Alright, 'man emerge' it is. Thanks.

Comment 4 nm (RETIRED) gentoo-dev

2007-11-19 07:51:40 UTC

Fixed in CVS.