| 1 |
dilfridge 12/08/30 17:16:58 |
| 2 |
|
| 3 |
Modified: kde4-guide.xml |
| 4 |
Log: |
| 5 |
General cleanup now that much info has moved to the wiki |
| 6 |
|
| 7 |
Revision Changes Path |
| 8 |
1.106 xml/htdocs/proj/en/desktop/kde/kde4-guide.xml |
| 9 |
|
| 10 |
file : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/proj/en/desktop/kde/kde4-guide.xml?rev=1.106&view=markup |
| 11 |
plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/proj/en/desktop/kde/kde4-guide.xml?rev=1.106&content-type=text/plain |
| 12 |
diff : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/proj/en/desktop/kde/kde4-guide.xml?r1=1.105&r2=1.106 |
| 13 |
|
| 14 |
Index: kde4-guide.xml |
| 15 |
=================================================================== |
| 16 |
RCS file: /var/cvsroot/gentoo/xml/htdocs/proj/en/desktop/kde/kde4-guide.xml,v |
| 17 |
retrieving revision 1.105 |
| 18 |
retrieving revision 1.106 |
| 19 |
diff -u -r1.105 -r1.106 |
| 20 |
--- kde4-guide.xml 30 Aug 2012 12:23:29 -0000 1.105 |
| 21 |
+++ kde4-guide.xml 30 Aug 2012 17:16:58 -0000 1.106 |
| 22 |
@@ -1,6 +1,6 @@ |
| 23 |
<?xml version="1.0" encoding="UTF-8"?> |
| 24 |
<!DOCTYPE guide SYSTEM "/dtd/guide.dtd"> |
| 25 |
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/proj/en/desktop/kde/kde4-guide.xml,v 1.105 2012/08/30 12:23:29 dilfridge Exp $ --> |
| 26 |
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/proj/en/desktop/kde/kde4-guide.xml,v 1.106 2012/08/30 17:16:58 dilfridge Exp $ --> |
| 27 |
|
| 28 |
<guide> |
| 29 |
<title>Gentoo KDE Guide</title> |
| 30 |
@@ -49,219 +49,18 @@ |
| 31 |
<body> |
| 32 |
|
| 33 |
<note> |
| 34 |
-This guide is being migrated step by step to the Gentoo wiki. Visit the |
| 35 |
-<uri link="http://wiki.gentoo.org/wiki/KDE">wiki page</uri> for more |
| 36 |
-information. |
| 37 |
+This guide is being migrated step by step to the Gentoo wiki. All information |
| 38 |
+about installing the KDE versions available in the main Portage tree has already |
| 39 |
+been moved. |
| 40 |
+<uri link="http://wiki.gentoo.org/wiki/KDE">Visit the wiki page</uri> for more |
| 41 |
+information. |
| 42 |
</note> |
| 43 |
- |
| 44 |
-<p> |
| 45 |
-KDE SC 4 is the current KDE version supported by upstream. In Portage there is a |
| 46 |
-stable version, and there might be one (or more) non-stable versions. Under |
| 47 |
-normal conditions new versions get in stabilized after a month. |
| 48 |
-In addition, KDE upstream provides <uri link="http://quickgit.kde.org">live git |
| 49 |
-source repositories</uri>. The Gentoo KDE team provides trunk and latest branch |
| 50 |
-live ebuilds through the <c>kde</c> overlay. |
| 51 |
-</p> |
| 52 |
- |
| 53 |
-<p> |
| 54 |
-Choose what KDE SC version is most appropriate for you: |
| 55 |
-</p> |
| 56 |
- |
| 57 |
-<table> |
| 58 |
- <tr> |
| 59 |
- <th>KDE SC Version</th> |
| 60 |
- <th>Repository</th> |
| 61 |
- </tr> |
| 62 |
- <tr> |
| 63 |
- <ti><uri link="#kde4_7">KDE SC 4.7.4</uri></ti> |
| 64 |
- <ti>Portage</ti> |
| 65 |
- </tr> |
| 66 |
- <tr> |
| 67 |
- <ti><uri link="#kde4_8">KDE SC 4.8.3</uri></ti> |
| 68 |
- <ti>Portage</ti> |
| 69 |
- </tr> |
| 70 |
- <tr> |
| 71 |
- <ti><uri link="#kde4_8">KDE SC 4.8.5</uri></ti> |
| 72 |
- <ti>Portage</ti> |
| 73 |
- </tr> |
| 74 |
- <tr> |
| 75 |
- <ti><uri link="#kde4_9">KDE SC 4.9.0</uri></ti> |
| 76 |
- <ti>Portage</ti> |
| 77 |
- </tr> |
| 78 |
- <tr> |
| 79 |
- <ti><uri link="#snapshots">KDE SC 4.9 Snapshots</uri></ti> |
| 80 |
- <ti>KDE Overlay</ti> |
| 81 |
- </tr> |
| 82 |
- <tr> |
| 83 |
- <ti><uri link="#live">Live Ebuilds (4.9 Branch, Trunk)</uri></ti> |
| 84 |
- <ti>KDE Overlay</ti> |
| 85 |
- </tr> |
| 86 |
-</table> |
| 87 |
- |
| 88 |
-</body> |
| 89 |
-</section> |
| 90 |
-</chapter> |
| 91 |
-<chapter id="prerequisites"> |
| 92 |
-<title>Prerequisites</title> |
| 93 |
-<section> |
| 94 |
-<title>Desktop profile and subprofiles</title> |
| 95 |
-<body> |
| 96 |
- |
| 97 |
-<p> |
| 98 |
-Desktop profile has been split to KDE and GNOME subprofiles. |
| 99 |
-This means that KDE and GNOME specific USE flags have been stripped |
| 100 |
-from the basic desktop profile and have been migrated to the subprofiles. |
| 101 |
-Choosing a subprofile doesn't restrict you to use only the equivalent |
| 102 |
-DE. In order to choose the profile that suits you, run <c>eselect profile list</c> |
| 103 |
-to get the profiles' list, and <c>eselect profile set X</c>, where X is the |
| 104 |
-appropriate number. |
| 105 |
-</p> |
| 106 |
- |
| 107 |
-</body> |
| 108 |
-</section> |
| 109 |
- |
| 110 |
-<section> |
| 111 |
-<title>Use flags</title> |
| 112 |
-<body> |
| 113 |
-<p> |
| 114 |
-Before you install KDE SC it is recommended that you set several useflags. |
| 115 |
-Part of that is done automatically if you use a desktop/kde or desktop profile. |
| 116 |
-In detail you should use: |
| 117 |
-</p> |
| 118 |
-<table> |
| 119 |
- <tr> |
| 120 |
- <th>flag</th> |
| 121 |
- <th>explanation</th> |
| 122 |
- </tr> |
| 123 |
- <tr> |
| 124 |
- <ti>consolekit</ti> |
| 125 |
- <ti>Enables the consolekit framework for defining and tracking users, login sessions and seats</ti> |
| 126 |
- </tr> |
| 127 |
- <tr> |
| 128 |
- <ti>dbus</ti> |
| 129 |
- <ti>Enables use of the dbus message bus system</ti> |
| 130 |
- </tr> |
| 131 |
- <tr> |
| 132 |
- <ti>policykit</ti> |
| 133 |
- <ti>Enables the <b>polkit</b> framework for controlling privileges for system-wide services</ti> |
| 134 |
- </tr> |
| 135 |
- <tr> |
| 136 |
- <ti>udev</ti> |
| 137 |
- <ti>Enables support for udev Linux dynamic and persistent device naming</ti> |
| 138 |
- </tr> |
| 139 |
-</table> |
| 140 |
-<p> |
| 141 |
-Note that other combinations may technically be possible, but may be unsupported, |
| 142 |
-untested, or lead to unexpected loss of functionality. |
| 143 |
-</p> |
| 144 |
-<p> |
| 145 |
-If you changed any global useflags, you should later include the -N flag when running the actual emerge command |
| 146 |
-which updates your system, e.g. |
| 147 |
-</p> |
| 148 |
-<pre caption="Updating world after a useflag change"> |
| 149 |
-# <i>emerge -uDNav world</i> |
| 150 |
-</pre> |
| 151 |
-</body> |
| 152 |
-</section> |
| 153 |
- |
| 154 |
-<section> |
| 155 |
-<title>Kernel settings</title> |
| 156 |
-<body> |
| 157 |
-<p> |
| 158 |
-If you are rolling your own kernel, you'll want to install a new one with the following options: |
| 159 |
-</p> |
| 160 |
-<pre caption="Recommended kernel settings"> |
| 161 |
-CONFIG_USB_SUSPEND=y |
| 162 |
-CONFIG_IDE=n |
| 163 |
-CONFIG_AUDITSYSCALL=y |
| 164 |
-</pre> |
| 165 |
</body> |
| 166 |
</section> |
| 167 |
- |
| 168 |
</chapter> |
| 169 |
-<chapter id="kde_portage"> |
| 170 |
-<title>Installing KDE SC from Portage</title> |
| 171 |
-<section id="kde4_7"> |
| 172 |
-<title>KDE SC 4.7</title> |
| 173 |
-<body> |
| 174 |
- |
| 175 |
-<p> |
| 176 |
-KDE SC 4.7.4 is the current stable release for amd64, ppc and x86. |
| 177 |
-</p> |
| 178 |
- |
| 179 |
-<pre caption="Installation of KDE SC 4.7 using meta packages"> |
| 180 |
-# <i>emerge -av kde-meta</i> <comment>(contains all of KDE modules)</comment> |
| 181 |
-# <i>emerge -av kdebase-meta kdegames-meta</i> <comment>(installation of chosen modules only)</comment> |
| 182 |
-</pre> |
| 183 |
- |
| 184 |
-<warn> |
| 185 |
-If you running KDEPIM and upgrade from 4.4 to 4.7, |
| 186 |
-please have a look at the <uri link="http://wiki.gentoo.org/wiki/KDEPIM-4.7_upgrade">Gentoo Wiki KDEPIM 4.7 |
| 187 |
-Upgrade Guide</uri> first! If you want to stick with KDEPIM 4.4 you can |
| 188 |
-<uri link="kdepim-4.7-mask.txt">mask KDEPIM 4.7</uri> |
| 189 |
-</warn> |
| 190 |
|
| 191 |
-</body> |
| 192 |
-</section> |
| 193 |
-<section id="kde4_8"> |
| 194 |
-<title>KDE SC 4.8</title> |
| 195 |
-<body> |
| 196 |
- |
| 197 |
-<p> |
| 198 |
-KDE SC 4.8.3 is under stabilization and already stable for amd64 and x86. KDE SC 4.8.5 is in portage, currently as ~testing, but stabilization is planned for the near future. |
| 199 |
-</p> |
| 200 |
- |
| 201 |
-<p> |
| 202 |
-Users with stable systems need to put <uri |
| 203 |
-link="http://git.overlays.gentoo.org/gitweb/?p=proj/kde.git;a=blob_plain;f=Documentation/package.keywords/kde-4.8.keywords"> |
| 204 |
-this keywords file</uri> in <path>/etc/portage/package.keywords</path>. |
| 205 |
-</p> |
| 206 |
- |
| 207 |
-<pre caption="Installation of KDE SC 4.8 using meta packages"> |
| 208 |
-# <i>emerge -av kde-meta</i> <comment>(contains all of KDE modules)</comment> |
| 209 |
-# <i>emerge -av kdebase-meta kdegames-meta</i> <comment>(installation of chosen modules only)</comment> |
| 210 |
-</pre> |
| 211 |
- |
| 212 |
-<warn> |
| 213 |
-If you running KDEPIM and upgrade from 4.4 to 4.8, |
| 214 |
-please have a look at the <uri link="http://wiki.gentoo.org/wiki/KDEPIM-4.7_upgrade">Gentoo Wiki KDEPIM 4.7 |
| 215 |
-Upgrade Guide</uri> first! If you want to stick with KDEPIM 4.4 you can |
| 216 |
-<uri link="kdepim-4.7-mask.txt">mask KDEPIM 4.8</uri> (Guide is still valid for 4.8). |
| 217 |
-</warn> |
| 218 |
- |
| 219 |
-</body> |
| 220 |
-</section> |
| 221 |
-<section id="kde4_9"> |
| 222 |
-<title>KDE SC 4.9</title> |
| 223 |
-<body> |
| 224 |
- |
| 225 |
-<p> |
| 226 |
-KDE SC 4.9.0 is in portage, currently as ~testing, stabilization isn't planned yet. |
| 227 |
-</p> |
| 228 |
- |
| 229 |
-<p> |
| 230 |
-Users with stable systems need to put <uri |
| 231 |
-link="http://git.overlays.gentoo.org/gitweb/?p=proj/kde.git;a=blob_plain;f=Documentation/package.keywords/kde-4.9.keywords"> |
| 232 |
-this keywords file</uri> in <path>/etc/portage/package.keywords</path>. |
| 233 |
-</p> |
| 234 |
- |
| 235 |
-<pre caption="Installation of KDE SC 4.9 using meta packages"> |
| 236 |
-# <i>emerge -av kde-meta</i> <comment>(contains all of KDE modules)</comment> |
| 237 |
-# <i>emerge -av kdebase-meta kdegames-meta</i> <comment>(installation of chosen modules only)</comment> |
| 238 |
-</pre> |
| 239 |
- |
| 240 |
-<warn> |
| 241 |
-If you running KDEPIM and upgrade from 4.4 to 4.9, |
| 242 |
-please have a look at the <uri link="http://wiki.gentoo.org/wiki/KDEPIM-4.7_upgrade">Gentoo Wiki KDEPIM 4.7 |
| 243 |
-Upgrade Guide</uri> first! If you want to stick with KDEPIM 4.4 you can |
| 244 |
-<uri link="kdepim-4.7-mask.txt">mask KDEPIM 4.9</uri> (Guide is still valid for 4.9). |
| 245 |
-</warn> |
| 246 |
- |
| 247 |
-</body> |
| 248 |
-</section> |
| 249 |
-</chapter> |
| 250 |
<chapter id="kde_overlay"> |
| 251 |
-<title>Installing KDE SC from Overlay</title> |
| 252 |
+<title>Installing KDE SC snapshots and live ebuilds from Overlay</title> |
| 253 |
<section id="kde_overlay_prerequisites"> |
| 254 |
<title>Prerequisites</title> |
| 255 |
<body> |
| 256 |
@@ -424,14 +223,10 @@ |
| 257 |
<body> |
| 258 |
|
| 259 |
<p> |
| 260 |
-One of the new features provided by Portage 2.2 is sets. |
| 261 |
-</p> |
| 262 |
- |
| 263 |
-<p> |
| 264 |
-Sets allow the KDE team to provide a complete replacement for the monolithic |
| 265 |
-packages, with the added bonus that users may choose to remove from the default |
| 266 |
-sets any packages they do not want. There is still some discussion going on |
| 267 |
-before we can put sets in the Portage tree. Thus, grab the sets from the |
| 268 |
+One of the new features provided by Portage 2.2 is sets, which can be used |
| 269 |
+as replacement for the metapackages. In general this is not recommended, |
| 270 |
+however it may provide advantages if you are using live ebuilds. Sets for the kde |
| 271 |
+packages can be obtained from the |
| 272 |
<c>kde</c> overlay <uri |
| 273 |
link="http://git.overlays.gentoo.org/gitweb/?p=proj/kde.git;a=tree;f=sets">sets |
| 274 |
directory</uri> or grab them as a <uri |
| 275 |
@@ -460,38 +255,9 @@ |
| 276 |
One can install the complete KDE by running <c>emerge -av @kde</c>. The specific |
| 277 |
version equivalents are very useful to uninstall an old version, e.g. <c>emerge |
| 278 |
-C @kde-3.5</c>, or to reinstall all packages from a specific version, e.g. |
| 279 |
-<c>emerge -av1 @kde-4x</c>. Advanced features, like removing any unwanted |
| 280 |
-packages from a set, will be supported in a future release of Portage -- you can |
| 281 |
-read more about it in <uri |
| 282 |
-link="http://blogs.gentoo.org/genone/2008/09/29/more_extensions_to_package_set_support">Marius |
| 283 |
-Mauch's (genone) blog</uri>. Part of this code has now been released in |
| 284 |
-portage-2.2_rc12, so you can reinstall all installed packages of a set |
| 285 |
-with <c>emerge -av @<set>/@installed</c> or to have a |
| 286 |
-<path>/etc/portage/sets/kdebase-unwanted</path> set and then run <c>emerge -av |
| 287 |
-@kdebase-@kdebase-unwanted</c>. |
| 288 |
-</p> |
| 289 |
- |
| 290 |
-<p> |
| 291 |
-We strongly recommend that you install the <c>kdebase</c> set in order to get a |
| 292 |
-full KDE 4 session. The example below would install the <c>kdebase</c> set and |
| 293 |
-the <c>kdegames</c> set. |
| 294 |
+<c>emerge -av1 @kde-4x</c>. |
| 295 |
</p> |
| 296 |
|
| 297 |
-<pre caption="Installing KDE SC"> |
| 298 |
-# <i>emerge @kdebase @kdegames</i> |
| 299 |
-</pre> |
| 300 |
- |
| 301 |
-<note> |
| 302 |
-If you want to check the list of sets known to Portage run the following: |
| 303 |
-<c>emerge --list-sets</c> |
| 304 |
-</note> |
| 305 |
- |
| 306 |
-<note> |
| 307 |
-All >= KDE 4.6 ebuilds require <c>portage-2.1.9.27</c> or greater, |
| 308 |
-which has implemented everything in the new EAPI 4 specification used in |
| 309 |
-these ebuilds (<c>>=sys-apps/portage-2.2_alpha11</c> is required to use sets). |
| 310 |
-</note> |
| 311 |
- |
| 312 |
</body> |
| 313 |
</section> |
| 314 |
<section id="cleanup"> |
| 315 |
@@ -565,59 +331,6 @@ |
| 316 |
|
| 317 |
</body> |
| 318 |
</section> |
| 319 |
-<section> |
| 320 |
-<title>Migrating configs from 3.5 to 4.X</title> |
| 321 |
-<body> |
| 322 |
- |
| 323 |
-<p> |
| 324 |
-KDE stores its configuration files in the <path>~/.kde</path> directory by |
| 325 |
-default. In the Gentoo ebuilds this has been changed in KDE 4.X to |
| 326 |
-allow for better integration of KDE 3.5 and 4.X when using the same user |
| 327 |
-account. If you export $KDEHOME this behaviour will be overridden. It is |
| 328 |
-strongly recommended that you do not do this. $KDEHOME will make KDE 3.5 and 4.X |
| 329 |
-use the same configuration directory which is usually not desired. |
| 330 |
-</p> |
| 331 |
- |
| 332 |
-<p> |
| 333 |
-KDE 3.5 uses <path>~/.kde</path> and the default FHS (<c>-kdeprefix</c>) KDE 4.X |
| 334 |
-uses <e>~/.kde4</e>. |
| 335 |
-</p> |
| 336 |
- |
| 337 |
-<p> |
| 338 |
-Settings are not migrated by default. If you want to attempt to migrate your |
| 339 |
-settings you should copy your old configuration directory to the new location |
| 340 |
-before logging in. For example: |
| 341 |
-</p> |
| 342 |
- |
| 343 |
-<pre caption="Copying the configuration directory"> |
| 344 |
-$ <i>cp -r ~/.kde ~/.kde4</i> |
| 345 |
-</pre> |
| 346 |
- |
| 347 |
-<p> |
| 348 |
-If this is successful, then your settings should all be migrated. If not, it is |
| 349 |
-possible to log out and remove the new configuration directory to start with a |
| 350 |
-clean configuration directory. |
| 351 |
-</p> |
| 352 |
- |
| 353 |
-<impo> |
| 354 |
-Moving backwards in version, from 4.X to 3.5, is not supported. |
| 355 |
-</impo> |
| 356 |
- |
| 357 |
-</body> |
| 358 |
-</section> |
| 359 |
</chapter> |
| 360 |
|
| 361 |
-<chapter> |
| 362 |
-<title>Archive</title> |
| 363 |
-<section> |
| 364 |
-<title>Upgrade from KDE SC 4.4 to 4.6</title> |
| 365 |
-<body> |
| 366 |
-<p> |
| 367 |
-KDE SC 4.6.3 is currently stable. If you encounter problems during the |
| 368 |
-upgrade from KDE SC 4.4, please have a look at the separate |
| 369 |
-<uri link="kde44-46-upgrade.xml">Gentoo KDE 4.4 - 4.6 Upgrade Guide</uri> first! |
| 370 |
-</p> |
| 371 |
-</body> |
| 372 |
-</section> |
| 373 |
-</chapter> |
| 374 |
</guide> |
Archives