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

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

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

Revision 1.15 Revision 1.16
1<?xml version='1.0' encoding='UTF-8'?> 1<?xml version='1.0' encoding='UTF-8'?>
2<!DOCTYPE sections SYSTEM "/dtd/book.dtd"> 2<!DOCTYPE sections SYSTEM "/dtd/book.dtd">
3 3
4<!-- The content of this document is licensed under the CC-BY-SA license --> 4<!-- The content of this document is licensed under the CC-BY-SA license -->
5<!-- See http://creativecommons.org/licenses/by-sa/2.5 --> 5<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
6 6
7<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-portage-branches.xml,v 1.15 2006/10/28 09:17:55 neysx Exp $ --> 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 8
9<sections> 9<sections>
10 10
11<abstract> 11<abstract>
12Gentoo provides software separated in several branches, depending on stability 12Gentoo provides software separated in several branches, depending on stability
13and architectural support. "Mixing Software Branches" inform you how these 13and architectural support. "Mixing Software Branches" inform you how these
14branches can be configured and how you can override this separation 14branches can be configured and how you can override this separation
15individually. 15individually.
16</abstract> 16</abstract>
17 17
18<version>1.7</version> 18<version>1.8</version>
19<date>2006-08-01</date> 19<date>2010-05-14</date>
20 20
21<section> 21<section>
22<title>Using One Branch</title> 22<title>Using One Branch</title>
23<subsection> 23<subsection>
24<title>The Stable Branch</title> 24<title>The Stable Branch</title>
25<body> 25<body>
26 26
27<p> 27<p>
28The ACCEPT_KEYWORDS variable defines what software branch you use on your 28The ACCEPT_KEYWORDS variable defines what software branch you use on your
29system. It defaults to the stable software branch for your architecture, for 29system. It defaults to the stable software branch for your architecture, for
30instance <c>x86</c>. 30instance <c>x86</c>.
31</p> 31</p>
32 32
33<p> 33<p>
34We recommend that you only use the stable branch. However, if you don't care 34We recommend that you only use the stable branch. However, if you don't care
87<section> 87<section>
88<title>Mixing Stable with Testing</title> 88<title>Mixing Stable with Testing</title>
89<subsection> 89<subsection>
90<title>The package.keywords location</title> 90<title>The package.keywords location</title>
91<body> 91<body>
92 92
93<p> 93<p>
94You can ask Portage to allow the testing branch for particular packages but use 94You can ask Portage to allow the testing branch for particular packages but use
95the stable branch for the rest of the system. To achieve this, add the package 95the stable branch for the rest of the system. To achieve this, add the package
96category and name you want to use the testing branch of in 96category and name you want to use the testing branch of in
97<path>/etc/portage/package.keywords</path>. You can also create a directory 97<path>/etc/portage/package.keywords</path>. You can also create a directory
98(with the same name) and list the package in the files under that directory. 98(with the same name) and list the package in the files under that directory.
99For instance, to use the testing branch for <c>gnumeric</c>: 99For instance, to use the testing branch for <c>gnumeric</c>:
100</p> 100</p>
101 101
102<pre caption="/etc/portage/package.keywords setting for gnumeric, full line"> 102<pre caption="/etc/portage/package.keywords setting for gnumeric">
103app-office/gnumeric ~x86 103app-office/gnumeric
104</pre> 104</pre>
105 105
106</body> 106</body>
107</subsection> 107</subsection>
108<subsection> 108<subsection>
109<title>Test Particular Versions</title> 109<title>Test Particular Versions</title>
110<body> 110<body>
111 111
112<p> 112<p>
113If you want to use a specific software version from the testing branch but you 113If you want to use a specific software version from the testing branch but you
114don't want Portage to use the testing branch for subsequent versions, you can 114don't want Portage to use the testing branch for subsequent versions, you can
115add in the version in the <path>package.keywords</path> location. In this case 115add in the version in the <path>package.keywords</path> location. In this case
116you <e>must</e> use the = operator. You can also enter a version range 116you <e>must</e> use the = operator. You can also enter a version range
117using the &lt;=, &lt;, &gt; or &gt;= operators. 117using the &lt;=, &lt;, &gt; or &gt;= operators.
118</p> 118</p>
119 119
120<p> 120<p>
121In any case, if you add version information, you <e>must</e> use an operator. If 121In any case, if you add version information, you <e>must</e> use an operator. If
122you leave out version information, you <e>cannot</e> use an operator. 122you leave out version information, you <e>cannot</e> use an operator.
123</p> 123</p>
124 124
125<p> 125<p>
126In the following example we ask Portage to accept gnumeric-1.2.13: 126In the following example we ask Portage to accept gnumeric-1.2.13:
127</p> 127</p>
128 128
129<pre caption="Enabling a particular gnumeric test version"> 129<pre caption="Enabling a particular gnumeric test version">
130=app-office/gnumeric-1.2.13 ~x86 130=app-office/gnumeric-1.2.13
131</pre> 131</pre>
132 132
133</body> 133</body>
134</subsection> 134</subsection>
135</section> 135</section>
136<section> 136<section>
137<title>Using Masked Packages</title> 137<title>Using Masked Packages</title>
138<subsection> 138<subsection>
139<title>The package.unmask location</title> 139<title>The package.unmask location</title>
140<body> 140<body>
141 141
142<p> 142<impo>
143The Gentoo developers do <b>not</b> support the use of this location. Please 143The Gentoo developers do <b>not</b> support the use of this location. Please
144exercise due caution when doing so. Support requests related to 144exercise 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 145<c>package.unmask</c> and/or <c>package.mask</c> will not be answered. You have
146been warned. 146been warned.
147</p> 147</impo>
148 148
149<p> 149<p>
150When a package has been masked by the Gentoo developers and you still want to 150When a package has been masked by the Gentoo developers and you still want to
151use it despite the reason mentioned in the <path>package.mask</path> file 151use it despite the reason mentioned in the <path>package.mask</path> file
152(situated in <path>/usr/portage/profiles</path> by default), add the 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 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). 154(or in a file in that directory if it is a directory).
155</p> 155</p>
156 156
157<p> 157<p>
158For instance, if <c>=net-mail/hotwayd-0.8</c> is masked, you can unmask it by 158For instance, if <c>=net-mail/hotwayd-0.8</c> is masked, you can unmask it by
159adding the exact same line in the <path>package.unmask</path> location: 159adding the exact same line in the <path>package.unmask</path> location:
160</p> 160</p>
161 161
162<pre caption="/etc/portage/package.unmask"> 162<pre caption="/etc/portage/package.unmask">

Legend:
Removed from v.1.15  
changed lines
  Added in v.1.16

  ViewVC Help
Powered by ViewVC 1.1.20