Hi,

in the x86 Quick Install Guide [1]  it is stated under "Code
Listing 2.38: Last edit of make.conf":
--snip--
You might want to recompile your whole system twice to make full use of
your latest configuration changes. It would take quite a long time to
complete and yield minimal speed benefits. It is recommended that you
let your system optimise itself gradually over time when new versions of
packages are released.
--end of snip--

Two remarks:
1.) The phrase "recompile your whole system twice" implicates (at least
for me) "emerge -e system && emerge -e system", while I read on the dev
list about the stage1-discussion [2], that it is recommend to do "emerge
-e world && emerge -e world && emerge --depclean", when you change your
compile options (well yes, and USE flags).

2.) In chapter "5.e. Configuring the Compile Options" [3] of the
Handbook there is nothing written comparing to this.


In the next Code Listing "Code Listing 2.39: Update your packages" of
the x86 Quick Install Guide there are some recommendations, what you
should, when you update your system:
--snip--
[...]
emerge libtool
[...]
etc-update
[...]
perl-cleaner all
[...]
python-updater
[...]
--end of snip--

Again you can find nothing about these recommendations in the handbook
in chapter "1.c. Maintaining Software" [4]. On the other hand you find
there the advise to run "emerge --depclean" and revdep-rebuild" after an
update of your complete system.


Any thoughts about this?
I think, both (handbook and guide) should be made consistent with each
other, with the handbook including some more informations about why you
should do this and that.

Regards,
Marc


[1] http://www.gentoo.org/doc/en/gentoo-x86-quickinstall.xml
[2]http://article.gmane.org/gmane.linux.gentoo.devel/33290/match=decision+remove+stage1+2+installation+documentation
[3]http://www.gentoo.org/doc/en/handbook/handbook-x86.xml?part=1&chap=5#doc_chap5
[4]http://www.gentoo.org/doc/en/handbook/handbook-x86.xml?part=2&chap=1#doc_chap3
-- 
gentoo-doc@g.o mailing list