Gentoo Archives: gentoo-commits

From: "Theo Chatzimichos (tampakrap)" <tampakrap@g.o>
To: gentoo-commits@l.g.o
Subject: [gentoo-commits] gentoo commit in xml/htdocs/proj/en/desktop/kde: kde4-guide.xml
Date: Sat, 27 Nov 2010 15:16:15
Message-Id: 20101127151603.2F8CD20051@flycatcher.gentoo.org
1 tampakrap 10/11/27 15:16:03
2
3 Modified: kde4-guide.xml
4 Log:
5 Restore the snapshots section, with installation instructions for 4.5.80
6 Various cleanup
7 Remove nonsense warnings/notes
8 Remove the Installing KDE apps section (it was completely useless)
9
10 Revision Changes Path
11 1.64 xml/htdocs/proj/en/desktop/kde/kde4-guide.xml
12
13 file : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/proj/en/desktop/kde/kde4-guide.xml?rev=1.64&view=markup
14 plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/proj/en/desktop/kde/kde4-guide.xml?rev=1.64&content-type=text/plain
15 diff : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/proj/en/desktop/kde/kde4-guide.xml?r1=1.63&r2=1.64
16
17 Index: kde4-guide.xml
18 ===================================================================
19 RCS file: /var/cvsroot/gentoo/xml/htdocs/proj/en/desktop/kde/kde4-guide.xml,v
20 retrieving revision 1.63
21 retrieving revision 1.64
22 diff -u -r1.63 -r1.64
23 --- kde4-guide.xml 3 Nov 2010 19:15:44 -0000 1.63
24 +++ kde4-guide.xml 27 Nov 2010 15:16:03 -0000 1.64
25 @@ -1,6 +1,6 @@
26 <?xml version="1.0" encoding="UTF-8"?>
27 <!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
28 -<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/proj/en/desktop/kde/kde4-guide.xml,v 1.63 2010/11/03 19:15:44 tampakrap Exp $ -->
29 +<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/proj/en/desktop/kde/kde4-guide.xml,v 1.64 2010/11/27 15:16:03 tampakrap Exp $ -->
30
31 <guide>
32 <title>Gentoo KDE Guide</title>
33 @@ -33,8 +33,8 @@
34 <!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
35 <license/>
36
37 -<version>2.1</version>
38 -<date>2010-03-11</date>
39 +<version>2.2</version>
40 +<date>2010-11-27</date>
41
42 <chapter>
43 <title>KDE 3</title>
44 @@ -88,15 +88,27 @@
45 <p>
46 Choose what KDE SC version is most appropriate for you:
47 </p>
48 +
49 <table>
50 <tr>
51 - <ti><uri link="#kde_portage">KDE SC from Portage (stable: 4.4.5, testing: 4.5.3)</uri></ti>
52 + <th>KDE SC Version</th>
53 + <th>Repository</th>
54 + </tr>
55 + <tr>
56 + <ti><uri link="#kde_portage">KDE SC 4.4.5</uri></ti>
57 + <ti>Portage</ti>
58 </tr>
59 - <!--tr>
60 - <ti><uri link="#snapshots">KDE SC snapshots (currently 4.4.XX)</uri></ti>
61 - </tr-->
62 <tr>
63 - <ti><uri link="#live">KDE live ebuilds (currently 4.5.9999, 9999)</uri></ti>
64 + <ti><uri link="#kde_portage">KDE SC 4.5.3</uri></ti>
65 + <ti>Portage</ti>
66 + </tr>
67 + <tr>
68 + <ti><uri link="#snapshots">KDE SC 4.5.xx snapshots</uri></ti>
69 + <ti>KDE Overlay</ti>
70 + </tr>
71 + <tr>
72 + <ti><uri link="#live">Live Ebuilds (4.5 Branch, Trunk)</uri></ti>
73 + <ti>KDE Overlay</ti>
74 </tr>
75 </table>
76
77 @@ -106,11 +118,6 @@
78 <title>Installing KDE SC 4.4.5 or 4.5.3 (from Portage)</title>
79 <body>
80
81 -<note>
82 -In order to minimize issues it is recommended to start with a clean environment.
83 -Read more in <uri link="#cleanup">Cleaning Up KDE</uri> section.
84 -</note>
85 -
86 <p>
87 KDE SC 4.4.5 is the currect stable release.
88 </p>
89 @@ -148,28 +155,85 @@
90
91 </body>
92 </section>
93 -<!--section id="snapshots">
94 -<title>Installing KDE 4.4.XX snapshots (from kde overlay)</title>
95 +<section id="snapshots">
96 +<title>Installing KDE 4.5.80 snapshots (from kde overlay)</title>
97 <body>
98
99 <p>
100 -Currently, KDE SC from trunk is too broken, especially the KDEPIM
101 -module. This is because kmail's mail storage is being ported to akonadi,
102 -which will take some time. Thus, we decided in February's <uri
103 -link="meeting-logs/kde-project-meeting-summary-20100225.txt">meeting</uri>
104 -not to provide any snapshots until KDEPIM is usuable again.
105 +KDE upstream provides <uri link="ftp://ftp.kde.org/pub/kde/unstable">weekly
106 +snapshots</uri> taken from the <uri link="http://websvn.kde.org/trunk/">SVN
107 +trunk tree</uri>. KDE now provides 4.5.xx snapshot series, and after the 4.6
108 +release they are going to start with 4.6.60. Beta and Release Candidate KDE
109 +releases are following the snapshot model below:
110 </p>
111
112 +<table>
113 + <tr>
114 + <th>KDE SC Version</th>
115 + <th>Release Name</th>
116 + </tr>
117 + <tr>
118 + <ti>4.x.80</ti>
119 + <ti>Beta 1</ti>
120 + </tr>
121 + <tr>
122 + <ti>4.x.85</ti>
123 + <ti>Beta 2</ti>
124 + </tr>
125 + <tr>
126 + <ti>4.x.90</ti>
127 + <ti>Release Candidate 1</ti>
128 + </tr>
129 + <tr>
130 + <ti>4.x.95</ti>
131 + <ti>Release Candidate 2</ti>
132 + </tr>
133 +</table>
134 +
135 +<p>
136 +Snapshots are only available through <c>kde</c> overlay, so first
137 +thing is to install it:
138 +</p>
139 +
140 +<pre caption="Installing kde overlay">
141 +# <i>layman -f -a kde</i>
142 +<comment>For more information regarding overlays, please read the <uri
143 +link="http://www.gentoo.org/proj/en/overlays/userguide.xml">Overlay Guide</uri></comment>
144 +</pre>
145 +
146 +<p>
147 +Users with stable systems have to keyword the packages to proceed. We provide a
148 +package.keyword file in <c>kde</c> overlay, which we'll have to symlink
149 +to our package.keywords directory:
150 +</p>
151 +
152 +<pre caption="Creating symlink of the keywords file">
153 +# <i>ln -s /path/to/overlay/kde/Documentation/package.keywords/kde-4.6.keywords /etc/portage/package.keywords</i>
154 +</pre>
155 +
156 +<p>
157 +The installation can be done either by using the meta packages or by using
158 +sets.
159 +</p>
160 +
161 +<pre caption="Installation using meta packages">
162 +# <i>emerge -av kde-meta</i> <comment>(contains all of KDE modules)</comment>
163 +# <i>emerge -av kdebase-meta kdegames-meta</i> <comment>(installation of chosen modules only)</comment>
164 +</pre>
165 +
166 +<pre caption="Installation using sets">
167 +# <i>emerge -av @kde-4.6</i> <comment>(contains all of KDE modules)</comment>
168 +# <i>emerge -av @kdebase-4.6 @kdegames-4.6</i> <comment>(installation of chosen modules only)</comment>
169 +
170 +<comment>See the <uri link="#sets">Using Sets</uri> section for more information.</comment>
171 +</pre>
172 +
173 </body>
174 -</section-->
175 +</section>
176 <section id="live">
177 <title>Installing KDE SC live ebuilds (from kde overlay)</title>
178 <body>
179
180 -<warn>
181 -KDE live ebuilds are <b>bleeding edge</b>. Use at your own risk.
182 -</warn>
183 -
184 <p>
185 KDE SC is Open Source, with its code being available for browsing through <uri
186 link="http://websvn.kde.org">KDE Websvn</uri>, and for public checkout
187 @@ -180,30 +244,20 @@
188 </p>
189
190 <table>
191 -<tr>
192 - <th>Ebuilds version</th>
193 - <th>KDE SC ersion</th>
194 -</tr>
195 -<tr>
196 - <ti>4.5.9999</ti>
197 - <ti>KDE 4.5 Branch</ti>
198 -</tr>
199 -<tr>
200 - <ti>9999</ti>
201 - <ti>KDE 4 Trunk</ti>
202 -</tr>
203 + <tr>
204 + <th>Ebuilds Version</th>
205 + <th>KDE SC Version</th>
206 + </tr>
207 + <tr>
208 + <ti>4.5.9999</ti>
209 + <ti>KDE 4.5 Branch</ti>
210 + </tr>
211 + <tr>
212 + <ti>9999</ti>
213 + <ti>KDE 4 Trunk</ti>
214 + </tr>
215 </table>
216
217 -<note>
218 -In order to minimize issues it is recommended to start with a clean environment.
219 -Read more in <uri link="#cleanup">Cleaning Up KDE</uri> section.
220 -</note>
221 -
222 -<note>
223 -You'll need portage-2.2_rc*, so please add <c>sys-apps/portage</c> entry in
224 -your <path>/etc/portage/package.unmask</path> file.
225 -</note>
226 -
227 <p>
228 Live ebuilds are only available through <c>kde</c> overlay, so first
229 thing is to install it:
230 @@ -221,7 +275,7 @@
231 to our package.keywords directory:
232 </p>
233
234 -<pre caption="Creating symlink of the kde-4.X.9999.keywords or kde-live file">
235 +<pre caption="Creating symlink of the keywords file">
236 # <i>cd /etc/portage/package.keywords</i>
237 # <i>ln -s /path/to/overlay/kde/Documentation/package.keywords/kde-4.5.9999.keywords .</i><comment>(for 4.5 Branch)</comment>
238 # <i>ln -s /path/to/overlay/kde/Documentation/package.keywords/kde-live.keywords .</i><comment>(for KDE Trunk)</comment>
239 @@ -232,49 +286,24 @@
240 sets.
241 </p>
242
243 -<pre caption="Installation of KDE live ebuilds using meta packages">
244 -<comment>(For KDE SC 4.5 Branch)</comment>
245 -# <i>emerge -av kde-meta:4.5</i> <comment>(contains all of KDE modules)</comment>
246 -# <i>emerge -av kdebase-meta:4.5 kdegames-meta:4.5</i> <comment>(installation of chosen modules only)</comment>
247 -<comment>(For KDE SC Trunk)</comment>
248 -# <i>emerge -av kde-meta:live</i> <comment>(contains all of KDE modules)</comment>
249 -# <i>emerge -av kdebase-meta:live kdegames-meta:live</i> <comment>(installation of chosen modules only)</comment>
250 +<pre caption="Installation using meta packages">
251 +# <i>emerge -av kde-meta</i> <comment>(contains all of KDE modules)</comment>
252 +# <i>emerge -av kdebase-meta kdegames-meta</i> <comment>(installation of chosen modules only)</comment>
253 </pre>
254
255 -<pre caption="Installation of KDE live ebuilds using sets">
256 -<comment>(For KDE SC 4.4 Branch)</comment>
257 -# <i>emerge -av @kde-4.4</i> <comment>(contains all of KDE modules)</comment>
258 -# <i>emerge -av @kdebase-4.4 @kdegames-4.4</i> <comment>(installation of chosen modules only)</comment>
259 +<pre caption="Installation using sets">
260 <comment>(For KDE SC 4.5 Branch)</comment>
261 # <i>emerge -av @kde-4.5</i> <comment>(contains all of KDE modules)</comment>
262 # <i>emerge -av @kdebase-4.5 @kdegames-4.5</i> <comment>(installation of chosen modules only)</comment>
263 <comment>(For KDE SC Trunk)</comment>
264 # <i>emerge -av @kde-live</i> <comment>(contains all of KDE modules)</comment>
265 # <i>emerge -av @kdebase-live @kdegames-live</i> <comment>(installation of chosen modules only)</comment>
266 +
267 <comment>See the <uri link="#sets">Using Sets</uri> section for more information.</comment>
268 </pre>
269
270 </body>
271 </section>
272 -<section>
273 -<title>Installation of KDE 4 Applications</title>
274 -<body>
275 -
276 -<p>
277 -In kde you may find live ebuilds of KDE 4 applications. These are
278 -slotted in :4, but they <b>can not</b> be installed in parallel with
279 -normal ones. You are free though to use live KDE 4 applications with KDE 4 from
280 -Portage, or to use Portage KDE 4 applications with your live KDE.
281 -</p>
282 -
283 -<note>
284 -There is also a set with live KDE 4 applications, @kde-extras-live and a
285 -set with live KOffice @koffice-live, in kde overlay, and a set with Qt
286 -live applications, @qt-extras-live, in qting-edge overlay.
287 -</note>
288 -
289 -</body>
290 -</section>
291 </chapter>
292
293 <chapter>
294 @@ -283,12 +312,6 @@
295 <title>Using Sets</title>
296 <body>
297
298 -<warn>
299 -Portage 2.2_rcX is currently masked. So if you want to use sets please unmask
300 -it by adding <c>sys-apps/portage</c> in your <c>/etc/portage.package.unmask</c>
301 -file.
302 -</warn>
303 -
304 <p>
305 One of the new features provided by Portage 2.2 is sets.
306 </p>
307 @@ -329,7 +352,7 @@
308 <c>emerge -av1 @kde-4x</c>. Advanced features, like removing any unwanted
309 packages from a set, will be supported in a future release of Portage -- you can
310 read more about it in <uri
311 -link="http://planet.gentoo.org/developers/genone/2008/09/29/more_extensions_to_package_set_support">Marius
312 +link="http://blogs.gentoo.org/genone/2008/09/29/more_extensions_to_package_set_support">Marius
313 Mauch's (genone) blog</uri>. Part of this code has now been released in
314 portage-2.2_rc12, so you can reinstall all installed packages of a set
315 with <c>emerge -av @&lt;set&gt;/@installed</c> or to have a