/[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.13 Revision 1.14
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.13 2006/03/14 19:29:29 neysx Exp $ --> 7<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-portage-branches.xml,v 1.14 2006/08/01 17:35:05 swift Exp $ -->
8 8
9<sections> 9<sections>
10 10
11<version>1.6</version> 11<version>1.7</version>
12<date>2005-08-11</date> 12<date>2006-08-01</date>
13 13
14<section> 14<section>
15<title>Using One Branch</title> 15<title>Using One Branch</title>
16<subsection> 16<subsection>
17<title>The Stable Branch</title> 17<title>The Stable Branch</title>
78</subsection> 78</subsection>
79</section> 79</section>
80<section> 80<section>
81<title>Mixing Stable with Testing</title> 81<title>Mixing Stable with Testing</title>
82<subsection> 82<subsection>
83<title>The package.keywords file</title> 83<title>The package.keywords location</title>
84<body> 84<body>
85 85
86<p> 86<p>
87You can ask Portage to allow the testing branch for particular packages but use 87You can ask Portage to allow the testing branch for particular packages but use
88the stable branch for the rest of the system. To achieve this, add the package 88the stable branch for the rest of the system. To achieve this, add the package
89category and name you want to use the testing branch of in 89category and name you want to use the testing branch of in
90<path>/etc/portage/package.keywords</path>. For instance, to use the testing 90<path>/etc/portage/package.keywords</path>. You can also create a directory
91branch for <c>gnumeric</c>: 91(with the same name) and list the package in the files under that directory.
92For instance, to use the testing branch for <c>gnumeric</c>:
92</p> 93</p>
93 94
94<pre caption="/etc/portage/package.keywords setting for gnumeric, full line"> 95<pre caption="/etc/portage/package.keywords setting for gnumeric, full line">
95app-office/gnumeric ~x86 96app-office/gnumeric ~x86
96</pre> 97</pre>
102<body> 103<body>
103 104
104<p> 105<p>
105If you want to use a specific software version from the testing branch but you 106If you want to use a specific software version from the testing branch but you
106don't want Portage to use the testing branch for subsequent versions, you can 107don't want Portage to use the testing branch for subsequent versions, you can
107add in the version in the <path>package.keywords</path> file. In this case you 108add in the version in the <path>package.keywords</path> location. In this case
108<e>must</e> use the = operator. You can also enter a version range 109you <e>must</e> use the = operator. You can also enter a version range
109using the &lt;=, &lt;, &gt; or &gt;= operators. 110using the &lt;=, &lt;, &gt; or &gt;= operators.
110</p> 111</p>
111 112
112<p> 113<p>
113In any case, if you add version information, you <e>must</e> use an operator. If 114In any case, if you add version information, you <e>must</e> use an operator. If
126</subsection> 127</subsection>
127</section> 128</section>
128<section> 129<section>
129<title>Using Masked Packages</title> 130<title>Using Masked Packages</title>
130<subsection> 131<subsection>
131<title>The package.unmask file</title> 132<title>The package.unmask location</title>
132<body> 133<body>
133 134
134<p> 135<p>
135The Gentoo developers do <b>not</b> support the use of these files. Please 136The Gentoo developers do <b>not</b> support the use of this location. Please
136exercise due caution when doing so. Support requests related to 137exercise due caution when doing so. Support requests related to
137<c>package.unmask</c> and/or <c>package.mask</c> will not be answered. You have 138<c>package.unmask</c> and/or <c>package.mask</c> will not be answered. You have
138been warned. 139been warned.
139</p> 140</p>
140 141
141<p> 142<p>
142When a package has been masked by the Gentoo developers and you still want to 143When a package has been masked by the Gentoo developers and you still want to
143use it despite the reason mentioned in the <path>package.mask</path> file 144use it despite the reason mentioned in the <path>package.mask</path> file
144(situated in <path>/usr/portage/profiles</path> by default), add the 145(situated in <path>/usr/portage/profiles</path> by default), add the
145<e>exact</e> same line in <path>/etc/portage/package.unmask</path>. 146<e>exact</e> same line in the <path>/etc/portage/package.unmask</path> file
147(or in a file in that directory if it is a directory).
146</p> 148</p>
147 149
148<p> 150<p>
149For instance, if <c>=net-mail/hotwayd-0.8</c> is masked, you can unmask it by 151For instance, if <c>=net-mail/hotwayd-0.8</c> is masked, you can unmask it by
150adding the exact same line in the <path>package.unmask</path> file: 152adding the exact same line in the <path>package.unmask</path> location:
151</p> 153</p>
152 154
153<pre caption="/etc/portage/package.unmask"> 155<pre caption="/etc/portage/package.unmask">
154=net-mail/hotwayd-0.8 156=net-mail/hotwayd-0.8
155</pre> 157</pre>
156 158
157</body> 159</body>
158</subsection> 160</subsection>
159<subsection> 161<subsection>
160<title>The package.mask file</title> 162<title>The package.mask location</title>
161<body> 163<body>
162 164
163<p> 165<p>
164When you don't want Portage to take a certain package or a specific version of a 166When you don't want Portage to take a certain package or a specific version of a
165package into account you can mask it yourself by adding an appropriate line to 167package into account you can mask it yourself by adding an appropriate line to
166<path>/etc/portage/package.mask</path>. 168the <path>/etc/portage/package.mask</path> location (either in that file or
169in a file in this directory).
167</p> 170</p>
168 171
169<p> 172<p>
170For instance, if you don't want Portage to install newer kernel sources than 173For instance, if you don't want Portage to install newer kernel sources than
171<c>gentoo-sources-2.6.8.1</c>, you add the following line to 174<c>gentoo-sources-2.6.8.1</c>, you add the following line at the
172<path>package.mask</path>: 175<path>package.mask</path> location:
173</p> 176</p>
174 177
175<pre caption="/etc/portage/package.mask example"> 178<pre caption="/etc/portage/package.mask example">
176&gt;sys-kernel/gentoo-sources-2.6.8.1 179&gt;sys-kernel/gentoo-sources-2.6.8.1
177</pre> 180</pre>

Legend:
Removed from v.1.13  
changed lines
  Added in v.1.14

  ViewVC Help
Powered by ViewVC 1.1.20