Gentoo Archives: gentoo-doc

From: Marc Blumentritt <M.Blumentritt@×××××××××××××××.de>
To: gentoo-doc@l.g.o
Subject: [gentoo-doc] Gentoo Handbook versus x86 Quick Install Guide
Date: Thu, 06 Jul 2006 08:39:15
Message-Id: 44ACCBB0.6090403@tu-braunschweig.de
1 Hi,
2
3 in the x86 Quick Install Guide [1] it is stated under "Code
4 Listing 2.38: Last edit of make.conf":
5 --snip--
6 You might want to recompile your whole system twice to make full use of
7 your latest configuration changes. It would take quite a long time to
8 complete and yield minimal speed benefits. It is recommended that you
9 let your system optimise itself gradually over time when new versions of
10 packages are released.
11 --end of snip--
12
13 Two remarks:
14 1.) The phrase "recompile your whole system twice" implicates (at least
15 for me) "emerge -e system && emerge -e system", while I read on the dev
16 list about the stage1-discussion [2], that it is recommend to do "emerge
17 -e world && emerge -e world && emerge --depclean", when you change your
18 compile options (well yes, and USE flags).
19
20 2.) In chapter "5.e. Configuring the Compile Options" [3] of the
21 Handbook there is nothing written comparing to this.
22
23
24 In the next Code Listing "Code Listing 2.39: Update your packages" of
25 the x86 Quick Install Guide there are some recommendations, what you
26 should, when you update your system:
27 --snip--
28 [...]
29 emerge libtool
30 [...]
31 etc-update
32 [...]
33 perl-cleaner all
34 [...]
35 python-updater
36 [...]
37 --end of snip--
38
39 Again you can find nothing about these recommendations in the handbook
40 in chapter "1.c. Maintaining Software" [4]. On the other hand you find
41 there the advise to run "emerge --depclean" and revdep-rebuild" after an
42 update of your complete system.
43
44
45 Any thoughts about this?
46 I think, both (handbook and guide) should be made consistent with each
47 other, with the handbook including some more informations about why you
48 should do this and that.
49
50 Regards,
51 Marc
52
53
54 [1] http://www.gentoo.org/doc/en/gentoo-x86-quickinstall.xml
55 [2]http://article.gmane.org/gmane.linux.gentoo.devel/33290/match=decision+remove+stage1+2+installation+documentation
56 [3]http://www.gentoo.org/doc/en/handbook/handbook-x86.xml?part=1&chap=5#doc_chap5
57 [4]http://www.gentoo.org/doc/en/handbook/handbook-x86.xml?part=2&chap=1#doc_chap3
58 --
59 gentoo-doc@g.o mailing list

Replies

Subject Author
[gentoo-doc] Re: Gentoo Handbook versus x86 Quick Install Guide Marc Blumentritt <M.Blumentritt@×××××××××××××××.de>
Re: [gentoo-doc] Gentoo Handbook versus x86 Quick Install Guide "Łukasz Damentko" <rane@g.o>