/[gentoo]/xml/htdocs/proj/en/desktop/kde/kde4-guide.xml
Gentoo

Diff of /xml/htdocs/proj/en/desktop/kde/kde4-guide.xml

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

Revision 1.107 Revision 1.108
1<?xml version="1.0" encoding="UTF-8"?> 1<?xml version="1.0" encoding="UTF-8"?>
2<!DOCTYPE guide SYSTEM "/dtd/guide.dtd"> 2<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
3<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/proj/en/desktop/kde/kde4-guide.xml,v 1.107 2012/09/06 11:41:50 johu Exp $ --> 3<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/proj/en/desktop/kde/kde4-guide.xml,v 1.108 2013/01/02 09:57:57 kensington Exp $ -->
4 4
5<guide> 5<guide disclaimer="obsolete" redirect="http://wiki.gentoo.org/wiki/KDE">
6<title>Gentoo KDE Guide</title> 6<title>Gentoo KDE Guide</title>
7 7
8<author title="Author"> 8<author title="Author">
9 <mail link="tampakrap"/> 9 <mail link="tampakrap"/>
10</author> 10</author>
11<author title="Author"> 11<author title="Author">
12 <mail link="dilfridge"/> 12 <mail link="dilfridge"/>
13</author> 13</author>
14<author title="Author"> 14<author title="Author">
15 <mail link="scarabeus"/> 15 <mail link="scarabeus"/>
16</author> 16</author>
17<author title="Author"> 17<author title="Author">
18 <mail link="jmbsvicetto"/> 18 <mail link="jmbsvicetto"/>
19</author> 19</author>
20<author title="Author"> 20<author title="Author">
… …
27 <mail link="keytoaster"/> 27 <mail link="keytoaster"/>
28</author> 28</author>
29<author title="Editor"> 29<author title="Editor">
30 <mail link="nightmorph"/> 30 <mail link="nightmorph"/>
31</author> 31</author>
32 32
33<abstract> 33<abstract>
34This guide demonstrates how to setup KDE SC using the ebuilds in the tree. Some 34This guide demonstrates how to setup KDE SC using the ebuilds in the tree. Some
35tools from the KDE team's git overlay (kde) may be used. 35tools from the KDE team's git overlay (kde) may be used.
36</abstract> 36</abstract>
37 37
38<!-- The content of this document is licensed under the CC-BY-SA license --> 38<!-- The content of this document is licensed under the CC-BY-SA license -->
39<!-- See http://creativecommons.org/licenses/by-sa/2.5 --> 39<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
40<license/> 40<license/>
41 41
42<version>3.23</version> 42<version>4</version>
43<date>2012-09-06</date> 43<date>2013-01-02</date>
44 44
45<chapter> 45<chapter>
46<title>KDE SC 4</title> 46<title>Moved</title>
47
47<section> 48<section>
48<title>Introduction</title> 49
49<body> 50<body>
50 51
51<note>
52This guide is being migrated step by step to the Gentoo wiki. All information
53about installing the KDE versions available in the main Portage tree has already
54been moved.
55<uri link="http://wiki.gentoo.org/wiki/KDE">Visit the wiki page</uri> for more
56information.
57</note>
58</body>
59</section>
60</chapter>
61
62<chapter id="kde_overlay">
63<title>Installing KDE SC snapshots and live ebuilds from Overlay</title>
64<section id="kde_overlay_prerequisites">
65<title>Prerequisites</title>
66<body>
67<p>
68Installing snapshots and live ebuilds are only available through <c>kde</c> overlay, so first
69thing is to install it:
70</p>
71
72<pre caption="Installing kde overlay">
73# <i>layman -f -a kde</i>
74<comment>For more information regarding overlays, please read the <uri
75link="http://www.gentoo.org/proj/en/overlays/userguide.xml">Overlay Guide</uri></comment>
76</pre>
77
78<impo> 52<impo>
79The <c>kde overlay</c> uses the thin manifest layout. For this 53This guide has moved to the <uri link="http://wiki.gentoo.org/wiki/KDE">Gentoo Wiki</uri>.
80<c>sys-apps/portage-2.1.10.18</c> or greater is required. Otherwise you will
81get missing manifest errors.
82</impo> 54</impo>
83
84</body>
85</section>
86
87<section id="snapshots">
88<title>Installing KDE SC snapshots</title>
89<body>
90
91<p>
92During testing phases KDE upstream provides <uri link="ftp://ftp.kde.org/pub/kde/unstable">
93snapshots</uri> taken from the git source repositories. Beta and Release Candidate KDE
94releases are following the snapshot model below:
95</p>
96
97<table>
98 <tr>
99 <th>KDE SC Version</th>
100 <th>Release Name</th>
101 </tr>
102 <tr>
103 <ti>4.x.80</ti>
104 <ti>Beta 1</ti>
105 </tr>
106 <tr>
107 <ti>4.x.90</ti>
108 <ti>Beta 2</ti>
109 </tr>
110 <tr>
111 <ti>4.x.95</ti>
112 <ti>Release Candidate 1</ti>
113 </tr>
114 <tr>
115 <ti>4.x.97</ti>
116 <ti>Release Candidate 2</ti>
117 </tr>
118</table>
119
120<note>
121Currently there are no snapshots available.
122</note>
123
124<!-- Enable this if first KDE SC 4.10 Snapshot is in overlay available -->
125<!--
126<p>
127Users with stable systems have to keyword the packages to proceed. We provide a
128package.keyword file in <c>kde</c> overlay. Due to masked depedencies, KDE SC
1294.9.80 should also be masked. We should symlink the files:
130</p>
131
132<pre caption="Creating symlink of the keywords file">
133# <i>ln -s /path/to/overlay/kde/Documentation/package.keywords/kde-4.10.keywords /etc/portage/package.keywords/</i>
134# <i>ln -s /path/to/overlay/kde/Documentation/package.unmask/kde-4.10 /etc/portage/package.unmask/</i>
135</pre>
136
137<p>
138The installation can be done either by using the meta packages or by using
139sets.
140</p>
141
142<pre caption="Installation using meta packages">
143# <i>emerge -av kde-meta</i> <comment>(contains all of KDE modules)</comment>
144# <i>emerge -av kdebase-meta kdegames-meta</i> <comment>(installation of chosen modules only)</comment>
145</pre>
146
147<pre caption="Installation using sets">
148<comment>(For KDE SC 4.10 Snapshots)</comment>
149# <i>emerge -av @kde-4.10</i> <comment>(contains all of KDE modules)</comment>
150# <i>emerge -av @kdebase-4.10 @kdegames-4.10</i> <comment>(installation of chosen modules only)</comment>
151</pre>
152-->
153
154</body>
155</section>
156<section id="live">
157<title>Installing KDE SC live ebuilds</title>
158<body>
159
160<p>
161KDE SC is Open Source, with its code being available for browsing through <uri
162link="http://quickgit.kde.org">KDE QuickGit</uri>, and for public checkout.
163Gentoo, as a source based distro, has the ability to provide live ebuilds that
164checkout the code either from the latest branch or from trunk. Currently, we
165provide 4.9.49.9999 ebuilds from 4.9 branch and 9999 ebuilds from trunk.
166</p>
167
168<table>
169 <tr>
170 <th>Ebuilds Version</th>
171 <th>KDE SC Version</th>
172 </tr>
173 <tr>
174 <ti>4.9.49.9999</ti>
175 <ti>KDE 4.9 Branch</ti>
176 </tr>
177 <tr>
178 <ti>9999</ti>
179 <ti>KDE 4 Trunk</ti>
180 </tr>
181</table>
182
183<p>
184Users with stable systems have to keyword the packages to proceed. We provide a
185package.keyword file in <c>kde</c> overlay, which we'll have to symlink
186to our package.keywords directory:
187</p>
188
189<pre caption="Creating symlink of the keywords file">
190# <i>cd /etc/portage/package.keywords</i>
191# <i>ln -s /path/to/overlay/kde/Documentation/package.keywords/kde-4.9.49.9999.keywords .</i><comment>(for 4.9 Branch)</comment>
192# <i>ln -s /path/to/overlay/kde/Documentation/package.keywords/kde-live.keywords .</i><comment>(for KDE Trunk)</comment>
193</pre>
194
195<p>
196The installation can be done either by using the meta packages or by using
197sets.
198</p>
199
200<pre caption="Installation using meta packages">
201# <i>emerge -av kde-meta</i> <comment>(contains all of KDE modules)</comment>
202# <i>emerge -av kdebase-meta kdegames-meta</i> <comment>(installation of chosen modules only)</comment>
203</pre>
204
205<pre caption="Installation using sets">
206<comment>(For KDE SC 4.9 Branch)</comment>
207# <i>emerge -av @kde-4.9</i> <comment>(contains all of KDE modules)</comment>
208# <i>emerge -av @kdebase-4.9 @kdegames-4.9</i> <comment>(installation of chosen modules only)</comment>
209<comment>(For KDE SC Trunk)</comment>
210# <i>emerge -av @kde-live</i> <comment>(contains all of KDE modules)</comment>
211# <i>emerge -av @kdebase-live @kdegames-live</i> <comment>(installation of chosen modules only)</comment>
212
213<comment>See the <uri link="#sets">Using Sets</uri> section for more information.</comment>
214</pre>
215
216</body>
217</section>
218</chapter>
219<chapter>
220<title>Additional Installation</title>
221<section id="sets">
222<title>Using Sets</title>
223<body>
224
225<p>
226One of the new features provided by Portage 2.2 is sets, which can be used
227as replacement for the metapackages. In general this is not recommended,
228however it may provide advantages if you are using live ebuilds. Sets for the kde
229packages can be obtained from the
230<c>kde</c> overlay <uri
231link="http://git.overlays.gentoo.org/gitweb/?p=proj/kde.git;a=tree;f=sets">sets
232directory</uri> or grab them as a <uri
233link="http://git.overlays.gentoo.org/gitweb/?p=proj/kde.git;a=snapshot;h=5b2fc54fa5d1c8aeddaeb05f044bf28754bb18be;sf=tbz2">
234tar.bz2 archive</uri> and put the ones you like in <path>/etc/portage/sets</path> --
235you can browse the list of sets provided by the KDE team in the overlay
236by using the first link.
237</p>
238
239<note>
240If you are using the kde overlay you can use sets directly
241instead of copying them to <path>/etc/portage/sets</path>.
242</note>
243
244<p>
245Amongst others, there are sets for each KDE tarball - @kdeaccessibility,
246@kdeadmin, @kdeartwork, @kdebase, @kdeedu, @kdegames, @kdegraphics,
247@kdemultimedia, @kdenetwork, @kdepim, @kdesdk, @kdetoys, and @kdeutils. There is
248also a set of sets (the equivalent to the old kde-meta package) @kde, and the
249same for specific versions @kde-3.5 and @kde-4x, a set for KDE deps @kdedeps, a
250set for optional packages @kdeoptional and a set for the split qt packages
251@qt-split.
252</p>
253
254<p>
255One can install the complete KDE by running <c>emerge -av @kde</c>. The specific
256version equivalents are very useful to uninstall an old version, e.g. <c>emerge
257-C @kde-3.5</c>, or to reinstall all packages from a specific version, e.g.
258<c>emerge -av1 @kde-4x</c>.
259</p>
260
261</body>
262</section>
263
264<section>
265<title>Localization/Internationalization</title>
266<body>
267
268<p>
269With new KDE there is new translators effort in Localization instead of
270Internationalization. This cause some confusion, but don't worry; just the name
271has been changed.
272</p>
273
274<pre caption="Getting the translations">
275<comment>For KDE 4 and Calligra:</comment>
276# <i>emerge kde-l10n</i>
277# <i>emerge calligra-l10n</i>
278</pre>
279 55
280</body> 56</body>
281</section> 57</section>
282</chapter> 58</chapter>
283 59
284</guide> 60</guide>
Legend:
Removed from v.1.107  
changed lines
  Added in v.1.108
  ViewVC Help
Powered by ViewVC 1.1.13