/[gentoo]/xml/htdocs/doc/en/handbook/hb-portage-branches.xml
Gentoo

Contents of /xml/htdocs/doc/en/handbook/hb-portage-branches.xml

Parent Directory Parent Directory | Revision Log Revision Log


Revision 1.17 - (show annotations) (download) (as text)
Wed Mar 2 09:25:49 2011 UTC (3 years, 5 months ago) by nightmorph
Branch: MAIN
Changes since 1.16: +10 -10 lines
File MIME type: application/xml
change the deprecated package.keywords references to package.accept_keywords, bug 337159

1 <?xml version='1.0' encoding='UTF-8'?>
2 <!DOCTYPE sections SYSTEM "/dtd/book.dtd">
3
4 <!-- The content of this document is licensed under the CC-BY-SA license -->
5 <!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
6
7 <!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-portage-branches.xml,v 1.16 2010/05/14 22:04:32 nightmorph Exp $ -->
8
9 <sections>
10
11 <abstract>
12 Gentoo provides software separated in several branches, depending on stability
13 and architectural support. "Mixing Software Branches" inform you how these
14 branches can be configured and how you can override this separation
15 individually.
16 </abstract>
17
18 <version>2</version>
19 <date>2011-03-02</date>
20
21 <section>
22 <title>Using One Branch</title>
23 <subsection>
24 <title>The Stable Branch</title>
25 <body>
26
27 <p>
28 The ACCEPT_KEYWORDS variable defines what software branch you use on your
29 system. It defaults to the stable software branch for your architecture, for
30 instance <c>x86</c>.
31 </p>
32
33 <p>
34 We recommend that you only use the stable branch. However, if you don't care
35 about stability this much and you want to help out Gentoo by submitting
36 bugreports to <uri>http://bugs.gentoo.org</uri>, read on.
37 </p>
38
39 </body>
40 </subsection>
41 <subsection>
42 <title>The Testing Branch</title>
43 <body>
44
45 <p>
46 If you want to use more recent software, you can consider using the testing
47 branch instead. To have Portage use the testing branch, add a ~ in front of your
48 architecture.
49 </p>
50
51 <p>
52 The testing branch is exactly what it says - <e>Testing</e>. If a package is in
53 testing, it means that the developers feel that it is functional but has not
54 been thoroughly tested. You could very well be the first to discover a bug in
55 the package in which case you could file a <uri
56 link="http://bugs.gentoo.org">bugreport</uri> to let the developers know about
57 it.
58 </p>
59
60 <p>
61 Beware though, you might notice stability issues, imperfect package handling
62 (for instance wrong/missing dependencies), too frequent updates (resulting in
63 lots of building) or broken packages. If you do not know how Gentoo works and
64 how to solve problems, we recommend that you stick with the stable and tested
65 branch.
66 </p>
67
68 <p>
69 For example, to select the testing branch for the x86 architecture, edit
70 <path>/etc/make.conf</path> and set:
71 </p>
72
73 <pre caption="Setting the ACCEPT_KEYWORDS variable">
74 ACCEPT_KEYWORDS="~x86"
75 </pre>
76
77 <p>
78 If you update your system now, you will find out that <e>lots</e> of packages
79 will be updated. Mind you though: when you have updated your system to use the
80 testing branch there is usually no easy way back to the stable, official branch
81 (except for using backups of course).
82 </p>
83
84 </body>
85 </subsection>
86 </section>
87 <section>
88 <title>Mixing Stable with Testing</title>
89 <subsection>
90 <title>The package.accept_keywords location</title>
91 <body>
92
93 <p>
94 You can ask Portage to allow the testing branch for particular packages but use
95 the stable branch for the rest of the system. To achieve this, add the package
96 category and name you want to use the testing branch of in
97 <path>/etc/portage/package.accept_keywords</path>. You can also create a
98 directory (with the same name) and list the package in the files under that
99 directory. For instance, to use the testing branch for <c>gnumeric</c>:
100 </p>
101
102 <pre caption="/etc/portage/package.accept_keywords setting for gnumeric">
103 app-office/gnumeric
104 </pre>
105
106 </body>
107 </subsection>
108 <subsection>
109 <title>Test Particular Versions</title>
110 <body>
111
112 <p>
113 If you want to use a specific software version from the testing branch but you
114 don't want Portage to use the testing branch for subsequent versions, you can
115 add in the version in the <path>package.accept_keywords</path> location. In this
116 case you <e>must</e> use the = operator. You can also enter a version range
117 using the &lt;=, &lt;, &gt; or &gt;= operators.
118 </p>
119
120 <p>
121 In any case, if you add version information, you <e>must</e> use an operator. If
122 you leave out version information, you <e>cannot</e> use an operator.
123 </p>
124
125 <p>
126 In the following example we ask Portage to accept gnumeric-1.2.13:
127 </p>
128
129 <pre caption="Enabling a particular gnumeric test version">
130 =app-office/gnumeric-1.2.13
131 </pre>
132
133 </body>
134 </subsection>
135 </section>
136 <section>
137 <title>Using Masked Packages</title>
138 <subsection>
139 <title>The package.unmask location</title>
140 <body>
141
142 <impo>
143 The Gentoo developers do <b>not</b> support the use of this location. Please
144 exercise due caution when doing so. Support requests related to
145 <c>package.unmask</c> and/or <c>package.mask</c> will not be answered. You have
146 been warned.
147 </impo>
148
149 <p>
150 When a package has been masked by the Gentoo developers and you still want to
151 use it despite the reason mentioned in the <path>package.mask</path> file
152 (situated in <path>/usr/portage/profiles</path> by default), add the
153 <e>exact</e> same line in the <path>/etc/portage/package.unmask</path> file
154 (or in a file in that directory if it is a directory).
155 </p>
156
157 <p>
158 For instance, if <c>=net-mail/hotwayd-0.8</c> is masked, you can unmask it by
159 adding the exact same line in the <path>package.unmask</path> location:
160 </p>
161
162 <pre caption="/etc/portage/package.unmask">
163 =net-mail/hotwayd-0.8
164 </pre>
165
166 </body>
167 </subsection>
168 <subsection>
169 <title>The package.mask location</title>
170 <body>
171
172 <p>
173 When you don't want Portage to take a certain package or a specific version of a
174 package into account you can mask it yourself by adding an appropriate line to
175 the <path>/etc/portage/package.mask</path> location (either in that file or
176 in a file in this directory).
177 </p>
178
179 <p>
180 For instance, if you don't want Portage to install newer kernel sources than
181 <c>gentoo-sources-2.6.8.1</c>, you add the following line at the
182 <path>package.mask</path> location:
183 </p>
184
185 <pre caption="/etc/portage/package.mask example">
186 &gt;sys-kernel/gentoo-sources-2.6.8.1
187 </pre>
188
189 </body>
190 </subsection>
191 </section>
192 </sections>

  ViewVC Help
Powered by ViewVC 1.1.20