Gentoo KDE Guide

-Installing KDE 4.2.4 (from Portage) +Installing KDE 4.2.4 or KDE 4.3.0 (from Portage) =20 KDE 4.3.0= is in -Portage tree but hardmasked until bug 280312 is fixed. To install/upgrad= e you can -follow the same procedure as for 4.2.4, by choosing the equivalent keywo= rds files -and sets/metas, and also using an unmask file from kde-testing as an add= itional step. +Portage tree but hardmasked until bug 280312 is fixed. =20

-KDE 4.2.4<= /uri> is the -KDE 4 version that Gentoo has in Portage - it's considered by upstream a= s the latest -stable. Currently it's in the testing branch in Portage, but in June's m= eeting the -Gentoo KDE Team decided to move forward with KDE 4 stabilization - 4.2.4= being the -best candidate. +KDE 4.2.4<= /uri> and +is the KDE 4.3.= 0 are +the KDE 4 versions that Gentoo has in Portage - they are considered by u= pstream as +the latest stable. Currently they are in the testing branch in Portage, = but in June's +meeting the Gentoo KDE Team decided to move forward with KDE 4 stabiliza= tion - 4.2.4 +being the best candidate.

=20 @@ -285,19 +284,50 @@ =20

Users with stable systems have to keyword the packages to proceed. -We provide a package.keyword file in kde-testing overlay under kde-testing overlay under=20 +Documentation/package.keywords/ directory -Documentation/package.keywords/ directory. +for KDE 4.2 and +for KDE 4.3.

=20

 # cd /etc/portage/
-# cat /path/to/kde-4.2.keywords/file >> package.keywords
+# cat /path/to/kde-4.2.keywords/file >> package.keywords For KDE 4.2
+# cat /path/to/kde-4.2.keywords/file >> package.keywords For KDE 4.3

=20 +

+If your package.keywords is a directory instead of a file you can do the +following: +

 # cd /etc/portage/package.keywords
-# cp /path/to/kde-4.2.keywords/file .
+# cp /path/to/kde-4.2.keywords/file . For KDE 4.2
+# cp /path/to/kde-4.3.keywords/file . For KDE 4.3
+

+ +

+Since KDE 4.3 is hardmasked, you will also need the unmask file that we +provide in kde-testing under +Documentation/package.unmask and do the following step: +

+ +

+# cd /etc/portage/
+# cat /path/to/kde-4.3/unmask/file >> package.keywords
+

+ +

+If your package.unmask is a directory, you can do the following: +

+ +

+# cd /etc/portage/package.unmask
+# cp /parth/to/kde-4.3/unmask/file .

=20

@@ -305,14 +335,35 @@

=20

+For KDE 4.2
 # emerge -av kde-meta:4.2 (contains all of KDE modules)<=
/comment>
 # emerge -av kdebase-meta:4.2 kdegames-meta:4.2 (install=
ation of chosen modules only)
+For KDE 4.3
+# emerge -av kde-meta:4.3 (contains all of KDE modules)<=
/comment>
+# emerge -av kdebase-meta:4.3 kdegames-meta:4.3 (install=
ation of chosen modules only)

=20

For installation using sets check the Using Sets section.

=20 +

+Upgrade Troubleshooting +

+ +

+If you=E2=80=99re trying to upgrade from KDE 4.2, but portage gives you = nice little blocks, +there are a few things you can check: +

+ +

Make sure you=E2=80=99ve synced the tree and/or kde-testing overlay= (if using it)
Make sure the unmask/keyword files are correct and up-to-date
Check that you don=E2=80=99t have any 4.2 versioned kde-base/* item= s in /var/lib/portage/world
Check that you don=E2=80=99t have any 4.2 versioned sets in /= var/lib/portage/world_sets
emerge -avDuN world =E2=80=94 you=E2=80=99ll probably get so= me messy output but all blocks should be automatically resolved