When you run `emerge --sync` and there's a new portage version available portage tells you to update it. This should not be done before you have bootstrap and `emerge system` completed as the compilation of depencies will fail. I suggest that you add a sentence about it to the install doc.
I haven't done an enormous amount of Gentoo installs, but it is more than the sum of all my fingers and toes and when asked, I've always first updated portage. Furthermore, the update will also happen quite early in the bootstrap if users don't do this manually. Why would dependencies fail?
Maybe this thread explains it better than me: http://article.gmane.org/gmane.linux.gentoo.user/54975
At step #9, after emerge sync, portage will mention there is a new portage version and it should be upgraded. According to the article in gmane, the user tried to do emerge system instead of emerge portage. I have installed Gentoo less times than I have fingers on my left hand (because they all worked 1st time and never had to be reinstalled contrary to other distros or alternative OS'es) but I believe emerge system at that point will not work. It has to be done at step #12, after bootstrap. It might be worth adding a small note about the warning users might receive after emerge sync telling them to emerge portage and nothing else at that point ? Or not do it at all if it does not work, I can't remember. Please confirm. Keep in mind that at that point users don't know anything about portage, yet. Hence the trip to google mentioned in the article.
Created attachment 21023 [details, diff] Patch to hb-install-system.xml
Created attachment 21024 [details, diff] Patch to gentoo-x86-install.xml
As far as I know, there are two possibilities: (1) the user ignores the recommendation and continues (as portage will be updated anyway due to "bootstrap.sh" or "emerge system" (2) the user explicitly updates portage first I've attached patches for the second possibility, but if you believe the first is preferred I can agree too.
Both options are ok, I don't prefer one over the other.
Patch looks good to me.
Okay, thanks for reporting this. It has now been corrected.
Hmm, reading -user today it seems that I was wrong, `emerge -u portage` isn't working before bootstrap: http://article.gmane.org/gmane.linux.gentoo.user/55799/
Portage should definitely not be upgraded until after bootstrapping (at which point it's irrelevant) - this is confusing a whole lot of people trying to install.
Created attachment 21287 [details, diff] Post-patch for gentoo-x86-install.xml
Created attachment 21288 [details, diff] Post-patch for hb-install-system.xml Please review ASAP
If the recommendation to upgrade portage is going to stay, one safe way I can think of to do it is with: USE="build" emerge -O portage
patches look good
Don't use such an emphasised "don't", it gives a bad impression that portage is broken. Instead use something like "ignore this as Portage will be updated as part of the bootstrap".
*** Bug 34460 has been marked as a duplicate of this bug. ***
Created attachment 21335 [details, diff] Post-patch for gentoo-x86-install.xml Rephrased patch.
Created attachment 21336 [details, diff] Post-patch for hb-install-system.xml Rephrased patch. Please review.
Created attachment 21366 [details, diff] Patch to gentoo-x86-install.xml
Created attachment 21367 [details, diff] Patch to hb-install-system.xml These patches use a phrazing of which I believe users don't feel weird :)
Committed. Thanks.