at stage 8 in the instructions in Code Listing 8.3 on the web page the instruction says to do env-update after chroot. This is not usefull as env-update does not have /etc/make.profile yet. And it is not available in the CD image (checked by exiting the chroot) as the link from /etc/make.profile goes into /usr/portage .. which is not populated at this point. Problem 1 - the command fails with an error message. Problem 2 - the error message suggests doing emerge sync to solve problem 1, but this is .. not desirable as the make.conf is not modified for local conditions at this stage. I followed the Stage 3 installation procedure verbatim on a Pentium I 200Mhz-MMX machine, IDE disks and boot support for CDROM. Went thru the procedure two times, scrubbing the disk with fdisk before the 2nd try. in the 2nd try I knew to edit the make.conf before doing the "emerge sync" and so I got the results suited for my machine. The first time everything was compiled with the default -march=i686 setting .. bad. Reproducible: Always Steps to Reproduce: 1. follow the instructions on the web page step by step on an i86 machine 2. in particular, execute env-update after chroot to unpacked stage3 3. Actual Results: got the error message from env-update that make.profile was not available and that an emerge sync should fix that. When I did the "emerge sync" it ran to completion and all looked okay. Then I update the USE list for the things I wanted, per Stage 10, and jumped to Stage 13 for the Stage 3 update. This took 2 days to run (I asked for too many things in the USE list :( and was all compiled with -march=i686, a bad thing for a Pent I machine. But it did not fail so not realizing the problem I pressed on. Eventually I configured and built the kernel. This is where I actually ran into building errors and figured out that I had to start over. I do not discuss these errors as they are irrelevant to the root cause of the bug I am reporting. Expected Results: The Stage 8 instructions should be modified no avoid the use of env-update OR the make.profile file should be provided in the CD image AND the instructions of Stage 8 should add a copy command "cp /etc/make.profile /mnt/gentoo/etc/" just before the chroot command in listing 8.3
What you receive isn't an error, it's a notice (warning) without consequences: """ >>> Note: /etc/make.profile/make.defaults isn't available. an 'emerge sync' will probably fix this. >>> Regenerating /etc/ld.so.cache... """ More recent Portage-versions don't give this notice anymore, but our current stage's still have the old version (if you want you can use the experimental stages, who don't have this notice anymore). Env-update doesn't terminate afterwards, it still creates the necessary environment variables and such. Concerning the default -march=i686 setting, it is explained in the docs that you need to set your CFLAGS and CXXFLAGS accordingly: """ You also should set appropriate CHOST, CFLAGS and CXXFLAGS settings for the kind of system that you are creating (commented examples can be found further down in the file.) """ This is in step 10. I'll ask Zhen if he sees it fit to add a note in the installation docs concerning the warning (even if the next stage-releases won't contain it anymore).
Changes to the docs are on it's way. Preview on http://cvs.gentoo.org/~swift/gentoo-x86-install.html until they are committed.
The doc has been changed and committed. Thanks for the feedback.