Add anoncvs gentoo-x86 example in documentation of repos.conf.
[portage.git] / cnf / make.conf.example.ppc.diff
1 --- make.conf.example
2 +++ make.conf.example
3 @@ -22,6 +22,13 @@
4  # Example:
5  #USE="X gtk gnome -alsa"
6  
7 +# Host Setting
8 +# ============
9 +#
10 +# All PowerPC systems should use this host setting:
11 +
12 +CHOST="powerpc-unknown-linux-gnu"
13 +
14  # Host and optimization settings 
15  # ==============================
16  #
17 @@ -39,10 +46,56 @@
18  # -frecord-gcc-switches, since otherwise the check could result in false
19  # positive results.
20  #
21 -# Please refer to the GCC manual for a list of possible values.
22 +# -mcpu=<cpu-type> for PowerPC systems selects the type of processor you want
23 +# to optimize your code for.   Code generated under those options will run best
24 +# on that processor, and may not run at all on others.
25 +#
26 +# GCC 3.4 supports many powerpc processor types including: 401, 403, 405,
27 +# 405fp, 440, 440fp, 505, 601, 602, 603, 603e, 604, 604e, 620, 630, 740, 7400,
28 +# 7450, 750, 801, 821, 823, 860, 970, 8540, common, ec603e, G3, G4, G5, power,
29 +# power2, power3, power4, power5, powerpc, powerpc64, rios, rios1, rios2, rsc,
30 +# and rs64a
31 +#
32 +# Recommended settings for GCC 3.4 only :
33 +#
34 +# -maltivec enables optional altivec support and should be used
35 +# only for G4 processors,  on GCC 3.2 or newer.  It also requires that you have
36 +# the alitvec option compiled into your kernel to take full advantage of this
37 +# feature.  Note: you should also include -mabi=altivec flag if using this 
38 +# option.
39 +#
40 +# The newer gcc has a stricter aliasing ruleset that makes type punned 
41 +# expression faulty compiled if -fstrict-aliasing is enabled.
42 +# That option is implied by -O2 -Os and -O3. Make SURE you don't have that
43 +# option enabled by adding -fno-strict-aliasing to your CFLAGS and CXXFLAGS
44 +#
45 +# Long term testing has shown that -O3 opts can be unreliable on G4's but work
46 +# on G3 series processors or earlier.
47  #
48 -#CFLAGS="-O2 -pipe"
49 +# The following is the suggested CFLAGS for a generic G4 cpu
50  #
51 +#CFLAGS="-O2 -pipe -mcpu=G4 -maltivec -mabi=altivec -fno-strict-aliasing"
52 +#
53 +#
54 +# All non G4 PPC boxen should choose this next option.  It will work fine for
55 +# all G3 and pre machines.  (note it will not hurt pre G3 machines either to 
56 +# use this mcpu option as it is the default for gcc 3.2.x anyway)
57 +#
58 +#CFLAGS="-O2 -pipe -mcpu=G3 -fno-strict-aliasing"
59 +
60 +# Recommended settings for GCC 2.95.3 only (Gentoo 1.2 or older):
61 +#
62 +# PowerPC 750 > up: this works on G3's and G4s, gcc 2.95.3 doesn't make the
63 +# distinction between G3 and G4, so this is fine for all NewWorld machines, if
64 +# you use yaboot to boot you should select this option
65 +#
66 +#CFLAGS="-O2 -pipe -mcpu=750 -mpowerpc-gfxopt -mmultiple -mstring"
67 +#
68 +# This will run on all other processors, by building more generic code This is
69 +# safe for all PPC machines running gcc 2.95.3, and works for all OldWorld
70 +# machines - if you use BootX to boot you should select this option
71 +#CFLAGS="-O2 -pipe -mmultiple -mstring"
72 +
73  # If you set a CFLAGS above, then this line will set your default C++ flags to
74  # the same settings.
75  #CXXFLAGS="${CFLAGS}"
76 @@ -76,7 +129,10 @@
77  # DO NOT PUT ANYTHING BUT YOUR SPECIFIC ~ARCHITECTURE IN THE LIST.
78  # IF YOU ARE UNSURE OF YOUR ARCH, OR THE IMPLICATIONS, DO NOT MODIFY THIS.
79  #
80 -#ACCEPT_KEYWORDS="~arch"
81 +# Note: this really shouldn't be enabled until _AFTER_ you bootstrap and emerge
82 +# system.  If you want the testing things update after these steps are completed.
83 +#
84 +#ACCEPT_KEYWORDS="~ppc"
85  
86  # ACCEPT_LICENSE is used to mask packages based on licensing restrictions.
87  # It may contain both license and group names, where group names are