/[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.9 Revision 1.10
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.0 --> 5<!-- See http://creativecommons.org/licenses/by-sa/2.0 -->
6 6
7<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-portage-branches.xml,v 1.9 2005/04/12 19:36:04 dertobi123 Exp $ --> 7<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-portage-branches.xml,v 1.10 2005/04/25 12:31:36 neysx Exp $ -->
8 8
9<sections> 9<sections>
10 10
11<version>1.4</version> 11<version>1.5</version>
12<date>2005-04-12</date> 12<date>2005-04-25</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>
18<body> 18<body>
19 19
20<p> 20<p>
21The ACCEPT_KEYWORDS variable defines what software branch you use on your 21The ACCEPT_KEYWORDS variable defines what software branch you use on your
22system. It defaults to the stable software branch for your architecture, for 22system. It defaults to the stable software branch for your architecture, for
23instance <c>x86</c>. 23instance <c>x86</c>.
24</p> 24</p>
25 25
26<p> 26<p>
27We recommend that you only use the stable branch. However, if you don't care 27We recommend that you only use the stable branch. However, if you don't care
28about stability this much and you want to help out Gentoo by submitting 28about stability this much and you want to help out Gentoo by submitting
29bugreports to <uri>http://bugs.gentoo.org</uri>, read on. 29bugreports to <uri>http://bugs.gentoo.org</uri>, read on.
30</p> 30</p>
31 31
32</body> 32</body>
33</subsection> 33</subsection>
34<subsection> 34<subsection>
35<title>The Testing Branch</title> 35<title>The Testing Branch</title>
36<body> 36<body>
37 37
38<p> 38<p>
39If you want to use more recent software you can consider using the testing 39If you want to use more recent software, you can consider using the testing
40branch instead. To have Portage use the testing branch, add a ~ in front of your 40branch instead. To have Portage use the testing branch, add a ~ in front of your
41architecture. 41architecture.
42</p> 42</p>
43 43
44<p> 44<p>
45The testing branch is exactly what it says - <e>Testing</e>. If a package is in
46testing, it means that the developers feel that it is functional but has not
47been thoroughly tested. You could very well be the first to discover a bug in
48the package in which case you could file a <uri
49link="http://bugs.gentoo.org">bugreport</uri> to let the developers know about
50it.
51</p>
52
53<p>
45For instance, to select the testing branch for the x86 architecture, edit 54For example, to select the testing branch for the x86 architecture, edit
46<path>/etc/make.conf</path> and set: 55<path>/etc/make.conf</path> and set:
47</p> 56</p>
48 57
49<pre caption="Setting the ACCEPT_KEYWORDS variable"> 58<pre caption="Setting the ACCEPT_KEYWORDS variable">
50ACCEPT_KEYWORDS="~x86" 59ACCEPT_KEYWORDS="~x86"
51</pre> 60</pre>
52 61
53<p> 62<p>
54If you update your system now, you will find out that <e>lots</e> of packages 63If you update your system now, you will find out that <e>lots</e> of packages
55will be updated. Mind you though: when you have updated your system to use the 64will be updated. Mind you though: when you have updated your system to use the
56testing branch there is usually no easy way back to the stable, official branch 65testing branch there is usually no easy way back to the stable, official branch
57(except for using backups of course). 66(except for using backups of course).
58</p> 67</p>
59 68
60</body> 69</body>
103 112
104<pre caption="Enabling a particular gnumeric test version"> 113<pre caption="Enabling a particular gnumeric test version">
105=app-office/gnumeric-1.2.13 ~x86 114=app-office/gnumeric-1.2.13 ~x86
106</pre> 115</pre>
107 116
108</body> 117</body>
109</subsection> 118</subsection>
110</section> 119</section>
111<section> 120<section>
112<title>Using Masked Packages</title> 121<title>Using Masked Packages</title>
113<subsection> 122<subsection>
114<title>The package.unmask file</title> 123<title>The package.unmask file</title>
115<body> 124<body>
116 125
117<p> 126<p>
127The Gentoo developers do <b>not</b> support the use of these files. Please
128exercise due caution while doing so. Support requests related to
129<c>package.unmask</c> and/or <c>package.mask</c> will not be answered. You have
130been warned.
131</p>
132
133<p>
118When a package has been masked by the Gentoo developers and you still want to 134When a package has been masked by the Gentoo developers and you still want to
119use it despite the reason mentioned in the <path>package.mask</path> file 135use it despite the reason mentioned in the <path>package.mask</path> file
120(situated in <path>/usr/portage/profiles</path> by default), add the 136(situated in <path>/usr/portage/profiles</path> by default), add the
121<e>exact</e> same line in <path>/etc/portage/package.unmask</path>. 137<e>exact</e> same line in <path>/etc/portage/package.unmask</path>.
122</p> 138</p>
123 139
124<p> 140<p>
125For instance, if <c>=net-mail/hotwayd-0.8</c> is masked, you can unmask it by 141For instance, if <c>=net-mail/hotwayd-0.8</c> is masked, you can unmask it by
126adding the exact same line in the <path>package.unmask</path> file: 142adding the exact same line in the <path>package.unmask</path> file:
127</p> 143</p>
128 144
129<pre caption="/etc/portage/package.unmask"> 145<pre caption="/etc/portage/package.unmask">
130=net-mail/hotwayd-0.8 146=net-mail/hotwayd-0.8
131</pre> 147</pre>
132 148

Legend:
Removed from v.1.9  
changed lines
  Added in v.1.10

  ViewVC Help
Powered by ViewVC 1.1.20