The Split KDE Ebuilds

The Split KDE Ebuilds @@ -422,55 +425,16 @@

-How can I unmerge an older KDE? - - -

-Suppose KDE 4.0 comes out and you want to unmerge the split ebuilds for KDE -3.4. Because they belong to different slots, emerge won't do this for you, so -another way is needed. -

- -

-A proper solution to this problem requires modifications to portage. One such -solution is described in -GLEP 21. -Until that is implemented, however, we must resort to scripts like the one -given below. -

- -

-Fortunately, all KDE ebuilds belong to the kde-base directory (and all ebuilds -in the kde-base category come from kde.org). So the following code works: -

- -

-# for x in `ls /usr/portage/kde-base`; do
-> if [ "$x" != "CVS" ]; then
-> echo -n "=kde-base/$x-3.4* "
-> fi
-> done |xargs emerge -Cp
-

- -

-The above looks a bit hackish, but ultimately it's not a hack because all -we really need is a list of ebuilds from kde-base. That's a very simple task -and so there will always be easy ways to accomplish it. -

- - -

How can I list/unmerge all split ebuilds derived from a given package?

The objective here is to list all split kde ebuilds derived from, say, the kdebase monolithic ebuild. Once again, the proper implementation (such as GLEP 21) -would make this trivial. Today, however, you must become involved in the -KDE eclasses' implementation details to some degree. So, if you use any of -these approaches in a script that's not for private use, tell us about it. +link="/proj/en/glep/glep-0021.html">GLEP 21) would make this trivial. +Today, however, you must become involved in the KDE eclasses' implementation +details to some degree. So, if you use any of these approaches in a script +that's not for private use, tell us about it.

1.16 +242 -70 xml/htdocs/doc/en/kde-config.xml file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/kde-config.xml?rev=1.16&content-type=text/x-cvsweb-markup&cvsroot=gentoo plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/kde-config.xml?rev=1.16&content-type=text/plain&cvsroot=gentoo diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/kde-config.xml.diff?r1=1.15&r2=1.16&cvsroot=gentoo Index: kde-config.xml =================================================================== RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/kde-config.xml,v retrieving revision 1.15 retrieving revision 1.16 diff -u -r1.15 -r1.16 --- kde-config.xml 20 Oct 2005 11:48:39 -0000 1.15 +++ kde-config.xml 30 Nov 2005 10:28:25 -0000 1.16 @@ -1,6 +1,6 @@ - + @@ -11,6 +11,9 @@ Sven Vermeulen + + Gregorio Guidi + One of the most used desktop environments is KDE. This guide tries to describe @@ -21,8 +24,8 @@ -1.10 -2005-10-20 +1.11 +2005-11-30 What is the K Desktop Environment? @@ -94,8 +97,9 @@

-KDE is also able to automatically mount devices for you. To use this feature, -add hal to your USE variable. +You should also add hal to your USE variable now if you want to add support +for mounting devices automatically as explained below in +Setup KDE to Mount Devices.

@@ -107,13 +111,19 @@

-Installing KDE < 3.4 - +Installing KDE as Monolithic Packages + + +

+The KDE project releases new versions of its desktop environment as a set of +about 16 big packages, each containing many applications (thus they are called +"monolithic"), so you need to decide which of these packages you want to +install. +

-Second, you need to think on what you want to install from the KDE distribution. -As mentioned before, KDE is very feature-rich and embraces lots of packages. You -don't have to believe our word for it -- just check yourself :) +If you want to see what it looks like to have all these packages installed, +just check yourself:

@@ -121,10 +131,10 @@

-If you're not interested in installing all those packages, you can emerge the -individual packages. You will most definitely want the kdebase package as -it contains KDE's base packages and necessities. The following table lists some -of the other available packages that you can install. +If you're not interested in installing all those packages, you can emerge them +individually. You will most definitely want the kdebase package as it +contains KDE's base packages and required dependencies. The following table +lists some of the other available packages that you can install.

@@ -143,15 +153,15 @@ kdeadmin KDE Administrative tools, such as KCron (Task Scheduling), - KUser (User Management) and KDat (Backup Management) + KUser (User Management) and KDat (Backup Management). kdeartwork Various art-related stuff, including screen savers and themes. See also artist.kde.org for more KDE related - artwork + link="http://www.kde-artists.org/">www.kde-artists.org for more KDE related + artwork. @@ -178,15 +188,6 @@ - kde-i18n - - Internationalization-related files for KDE. This includes support for - foreign languages (and currencies, number/date formats, ...) and - documentation. See also the KDE i18n - project for more information. - - -kdemultimedia Multimedia-related applications, including support for CD, MP3, DVD, @@ -198,9 +199,9 @@ kdenetwork - Network-related applications such as kppp (Dial-In) and lisa - (Networking). Note that konqueror (File Manager and Browser) - is part of kdebase! + Network-related applications such as Kopete (Multi-Protocol Instant + Messaging), kppp (Dial-In) and KSirc (IRC client). Note that + konqueror (File Manager and Browser) is part of kdebase! @@ -236,6 +237,14 @@ terminal), kfloppy (Floppy-related actions), etc. + + kde-i18n + + Internationalization files for KDE. This includes translated + documentation. See also the KDE i18n + project for more information. + +

@@ -248,20 +257,26 @@

-In case you wonder: compiling KDE does take a while :) +In case you wonder: compiling KDE does take a while.

-Installing KDE >= 3.4 +Installing KDE as Split Packages

-More recent KDE versions (from 3.4 onwards) are presented as a plethora of -split ebuilds, making it a tad -more difficult to know what to install and what not. Gentoo does provide a few -meta packages that will pull in a certain amount of KDE packages for you: +If you want to have even more control on what parts of KDE you install, you +have the possibility to install just the single KDE applications that you need. +To know more about the ebuilds for the individual KDE programs see the Split Ebuilds HOWTO. +

+ +

+Knowing what to install and what not is a tad more difficult with split ebuilds. +However, Gentoo does provide a few meta packages that will pull in a certain +amount of KDE packages for you:

amarok

akregator

- With amaroK you have a powerful - music player for Unix/Linux. + The application to easily manage and browse internet RSS feeds.

k3b

juk

- K3B is a complete CD/DVD burning - utility with Audio support. Burning CDs was never this easy. -

kaffeine

- Kaffeine is a full - featured multimedia-player for KDE. + The playlist oriented media player, with a look and feel resembling Apple's + iTunes.

knode

+ KNode is the powerful KDE newsreader. +

konqueror

With Konqueror you have a @@ -413,7 +426,7 @@

-And this is just a small tip of the iceberg. If you want to know more about all +And this is just the tip of the iceberg. If you want to know more about all possible KDE applications, take a look inside the kde-base category. Their function should be available in the description. @@ -432,21 +445,60 @@

If you are happy with the proposed result, leave the -p out. This building process will take some time as KDE is a big environment. Don't be -surprised when your system does not finish immediately :-) +surprised when your system does not finish immediately.

+ +

+External KDE applications + +

-If you want KDE to auto-mount your devices you'll need to install dbus, -hal and ivman as well after which you add each one of them to the -default run level: +The number of KDE applications is not limited to those shipped with the +official KDE releases, but includes hundreds of other applications that use the +KDE framework and libraries. Here we list just a few of the most popular ones.

-# emerge dbus hal ivman
-# rc-update add dbus default
-# rc-update add hald default
-# rc-update add ivman default
-

+ + + + + + + koffice + + KOffice is the comprehensive KDE + office suite, featuring applications for word processing (KWord), + spreadsheet calculations (KSpread), presentation (KPresenter), image + manipulation (Krita), database management (Kexi) and much more. + Just as KDE can be installed through the kde or kde-meta + ebuilds, you can install KOffice as a single package (koffice) or as + a set of individual packages (koffice-meta). + + + + amarok + + With amaroK you have a powerful + music player for Unix/Linux. + + + + k3b + + K3B is a complete CD/DVD burning + utility with Audio support. Burning CDs was never this easy. + + + + kaffeine + + Kaffeine is a full + featured multimedia-player for KDE. + + +

Ebuild name	Description

@@ -516,7 +568,7 @@ Next, KPersonalizer asks for the amount of eye-candy it should activate. The more eye-candy you want, the funkier your KDE will be, but the more your CPU will be stressed. However, this should be taken with a bit of salt - on a 600 -Mhz CPU with 128 Mb of memory, enabling full eye candy still results in a +Mhz CPU with 128 Mb of memory, enabling full eye-candy still results in a responsive system.

@@ -596,7 +648,7 @@

-Finish up by adding xdm to the default run level: +Finish up by adding xdm to the default runlevel:

@@ -616,8 +668,137 @@
 
 
 
+
+Setup KDE to Mount Devices
+
+
+
+KDE gives you the power to mount devices such as CDROMs or USB sticks through a
+single click in a graphical interface.  To accomplish this goal you need to
+have KDE compiled with hal in your USE variable and to have
+dbus, hal and pmount installed on your system.  You should
+also add dbus and hal to the default runlevel and add yourself to
+the plugdev group.
+
+
++# emerge --noreplace dbus hal pmount
+# rc-update add dbus default
+# rc-update add hald default
+Add <user> to the plugdev group
+# gpasswd -a <user> plugdev
+
+
+
+You can also have your devices automatically mounted without interaction, you
+just need to install ivman and add it to the default runlevel.
+
+
++# emerge --noreplace ivman
+# rc-update add ivman default
+
+
+
+
 
+
+Managing KDE Installations
+
+Multiple Installations
+
+
+
+One peculiarity of the way KDE is managed in Gentoo is that when a new series
+of KDE appears (such as the 3.5.x series, which supersedes the 3.4.x series)
+it will be installed alongside the old one and will not overwrite it.  So if
+for instance you had KDE 3.4 already installed and you emerge KDE 3.5,
+you will have two versions, one installed in /usr/kde/3.4/ and
+the other in /usr/kde/3.5/.
+
 
+
+It should be noted that your settings for different KDE installations will be
+kept separate in the home directory.  KDE 3.4 reads its settings from the
+directory /home/<user>/.kde3.4, and the first time you run
+KDE 3.5 a directory named /home/<user>/.kde3.5 will be
+created by migrating the settings in the 3.4 directory and will be then used to
+store preferences and data.
+
+
+
+Another important remark to keep in mind when upgrading your KDE installation
+is that you could have problems with the external KDE applications you have
+installed (such as koffice, amarok or k3b) until you
+recompile them against the new KDE version.  So as soon as you start using the
+new KDE you should reemerge them to make them link against the new libraries.
+
+
+
+
+
+Unmerging Old Versions
+
+
+
+Having multiple versions of KDE installed poses the problem of how to remove
+the old ones when we decide that they are not needed anymore.  Unfortunately
+portage does not support unmerging a package with all its dependencies with a
+single command, so if for instance you run emerge --unmerge kde you will
+not remove the actual kde packages.
+
+
+
+To remove a KDE installation (e.g. KDE 3.4), the single packages have to be
+removed.
+
+
++# emerge --unmerge =arts-3.4* =kdelibs-3.4* =kdebase-3.4* ...
+
+
+
+Obviously this is very frustrating if you have many KDE packages installed.
+However this operation can be automated in many ways.  The following one is
+an example.
+
+
+
+First we list all the packages that we want to remove.
+
+
++(List all the installed KDE packages)
+# equery list kde-base/
+(List all the installed KDE packages and select the ones from KDE 3.4)
+# equery list kde-base/ | grep 3.4
+
+
+
+At this point you should double-check that the list corresponds to the packages
+that should be removed from the system.  If you think it is ok, you can go on
+and pass the list to the emerge --unmerge command.
+
+
++# equery list kde-base/ | grep 3.4 | xargs emerge --unmerge --pretend
+
+
+
+Check again the output and reissue the command without --pretend to
+start the unmerging process.
+
+
+
+After the job has completed, the directory /usr/kde/3.4/ should
+contain only a few files (mainly configuration files, portage has a policy to
+never touch configurations).  If you desire, you can safely wipe out
+/usr/kde/3.4/ with its content to remove what remains of KDE 3.4.
+
+
+
+
+
 
 Frequently Asked Questions
 
@@ -651,15 +832,6 @@
 (...)

-If you don't have an IPv6-enabled network, disable KDE's IPv6 checking by -adding the following line to /etc/env.d/99kde-env: -

- -

-KDE_NO_IPV6 = 1
-