Bug 34460

Summary:	Sync portage tree chapter unclear about updating portage
Product:	[OLD] Docs-user	Reporter:	Chris Millard <dalcius>
Component:	Gentoo Linux x86 Installation Guide	Assignee:	Docs Team <docs-team>
Status:	RESOLVED DUPLICATE
Severity:	minor
Priority:	Normal
Version:	unspecified
Hardware:	x86
OS:	Linux
URL:	http://www.gentoo.org/doc/en/gentoo-x86-install.xml#doc_chap9
Whiteboard:
Package list:		Runtime testing required:	---

Description Chris Millard 2003-11-26 12:56:54 UTC

Chapter 9 (Getting the Current Portage Tree using sync) of the x86 install doc specifically tells non-GRP users to attempt to update portage if 'emerge sync' warns about a new version.

To quote the guide:
-----
If you are warned that a new Portage version is available and that you should update Portage, run emerge -u portage to get your Portage up to date:

Code listing 9.2: Updating Portage

# emerge -u portage
-----

To my understanding, this is not appropriate for those installing via the Stage 1 route as the system has not yet been bootstrapped.  If a Stage 1 user attempts to update portage, the following error is encountered (after "gnuconfig" and "patch" are emerged successfully):
-----
checking how to run the C++ preprocessor... /lib/cpp
configure: error: C++ preprocessor "lib/cpp" fails sanity check

!!! ERROR: sys-libs/ncurses-5.3-r2 failed.
!!! Function econf, Line 324, Exitcode 1
!!! econf failed 
-----

A related forum thread can be found here:
http://forums.gentoo.org/viewtopic.php?t=109079

Comment 1 Sven Vermeulen (RETIRED) gentoo-dev

2003-11-26 13:09:38 UTC


*** This bug has been marked as a duplicate of 33977 ***