neysx 05/11/30 10:28:25 Modified: xml/htdocs/doc/en kde-split-ebuilds.xml kde-config.xml Log: #113964 Large update from Gregorio
Revision Changes Path 1.9 +10 -46 xml/htdocs/doc/en/kde-split-ebuilds.xml file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/kde-split-ebuilds.xml?rev=1.9&content-type=text/x-cvsweb-markup&cvsroot=gentoo plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/kde-split-ebuilds.xml?rev=1.9&content-type=text/plain&cvsroot=gentoo diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/kde-split-ebuilds.xml.diff?r1=1.8&r2=1.9&cvsroot=gentoo Index: kde-split-ebuilds.xml =================================================================== RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/kde-split-ebuilds.xml,v retrieving revision 1.8 retrieving revision 1.9 diff -u -r1.8 -r1.9 --- kde-split-ebuilds.xml 30 Oct 2005 18:26:17 -0000 1.8 +++ kde-split-ebuilds.xml 30 Nov 2005 10:28:25 -0000 1.9 @@ -1,6 +1,6 @@ <?xml version='1.0' encoding='UTF-8'?> -<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/kde-split-ebuilds.xml,v 1.8 2005/10/30 18:26:17 so Exp $ --> +<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/kde-split-ebuilds.xml,v 1.9 2005/11/30 10:28:25 neysx Exp $ --> <!DOCTYPE guide SYSTEM "/dtd/guide.dtd"> @@ -11,6 +11,9 @@ <author title="Author"> <mail link="[EMAIL PROTECTED]">Dan Armak</mail> </author> +<author title="Editor"> + <mail link="[EMAIL PROTECTED]">Gregorio Guidi</mail> +</author> <abstract> With KDE 3.4, the 'split ebuilds' were introduced into Portage. This page @@ -22,8 +25,8 @@ <!-- See http://creativecommons.org/licenses/by-sa/2.5 --> <license/> -<version>1.6</version> -<date>2005-10-30</date> +<version>1.7</version> +<date>2005-11-30</date> <chapter> <title>The Split KDE Ebuilds</title> @@ -422,55 +425,16 @@ </body> </section> <section> -<title>How can I unmerge an older KDE?</title> -<body> - -<p> -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. -</p> - -<p> -A proper solution to this problem requires modifications to portage. One such -solution is described in -<uri link="http://www.gentoo.org/proj/en/glep/glep-0021.html";>GLEP 21</uri>. -Until that is implemented, however, we must resort to scripts like the one -given below. -</p> - -<p> -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: -</p> - -<pre caption="Removing KDE 3.4 from the system"> -# <i>for x in `ls /usr/portage/kde-base`; do</i> -> <i>if [ "$x" != "CVS" ]; then</i> -> <i>echo -n "=kde-base/$x-3.4* "</i> -> <i>fi</i> -> <i>done |xargs emerge -Cp</i> -</pre> - -<p> -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. -</p> - -</body> -</section> -<section> <title>How can I list/unmerge all split ebuilds derived from a given package?</title> <body> <p> The objective here is to list all split kde ebuilds derived from, say, the kdebase monolithic ebuild. Once again, the proper implementation (such as <uri -link="http://www.gentoo.org/proj/en/glep/glep-0021.html";>GLEP 21</uri>) -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</uri>) 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. </p> <p> 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 @@ <?xml version='1.0' encoding='UTF-8'?> -<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/kde-config.xml,v 1.15 2005/10/20 11:48:39 jkt Exp $ --> +<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/kde-config.xml,v 1.16 2005/11/30 10:28:25 neysx Exp $ --> <!DOCTYPE guide SYSTEM "/dtd/guide.dtd"> @@ -11,6 +11,9 @@ <author title="Author"> <mail link="[EMAIL PROTECTED]">Sven Vermeulen</mail> </author> +<author title="Editor"> + <mail link="[EMAIL PROTECTED]">Gregorio Guidi</mail> +</author> <abstract> One of the most used desktop environments is KDE. This guide tries to describe @@ -21,8 +24,8 @@ <!-- See http://creativecommons.org/licenses/by-sa/2.5 --> <license/> -<version>1.10</version> -<date>2005-10-20</date> +<version>1.11</version> +<date>2005-11-30</date> <chapter> <title>What is the K Desktop Environment?</title> @@ -94,8 +97,9 @@ </p> <p> -KDE is also able to automatically mount devices for you. To use this feature, -add <c>hal</c> to your USE variable. +You should also add <c>hal</c> to your USE variable now if you want to add support +for mounting devices automatically as explained below in +<uri link="#kde_device_mounting">Setup KDE to Mount Devices</uri>. </p> <p> @@ -107,13 +111,19 @@ </body> </section> <section> -<title>Installing KDE < 3.4</title> -<body> <!-- TODO Remove this section when 3.4 is stabilized on all archs --> +<title>Installing KDE as Monolithic Packages</title> +<body> + +<p> +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. +</p> <p> -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: </p> <pre caption="Listing all packages KDE would install"> @@ -121,10 +131,10 @@ </pre> <p> -If you're not interested in installing all those packages, you can emerge the -individual packages. You will most definitely want the <c>kdebase</c> 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 <c>kdebase</c> 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. </p> <table> @@ -143,15 +153,15 @@ <ti>kdeadmin</ti> <ti> KDE Administrative tools, such as <c>KCron</c> (Task Scheduling), - <c>KUser</c> (User Management) and <c>KDat</c> (Backup Management) + <c>KUser</c> (User Management) and <c>KDat</c> (Backup Management). </ti> </tr> <tr> <ti>kdeartwork</ti> <ti> Various art-related stuff, including screen savers and themes. See also <uri - link="http://artist.kde.org";>artist.kde.org</uri> for more KDE related - artwork + link="http://www.kde-artists.org/";>www.kde-artists.org</uri> for more KDE related + artwork. </ti> </tr> <tr> @@ -178,15 +188,6 @@ </ti> </tr> <tr> - <ti>kde-i18n</ti> - <ti> - Internationalization-related files for KDE. This includes support for - foreign languages (and currencies, number/date formats, ...) and - documentation. See also the <uri link="http://i18n.kde.org";>KDE i18n - project</uri> for more information. - </ti> -</tr> -<tr> <ti>kdemultimedia</ti> <ti> Multimedia-related applications, including support for CD, MP3, DVD, @@ -198,9 +199,9 @@ <tr> <ti>kdenetwork</ti> <ti> - Network-related applications such as <c>kppp</c> (Dial-In) and <c>lisa</c> - (Networking). Note that <c>konqueror</c> (File Manager <e>and</e> Browser) - is part of <c>kdebase</c>! + Network-related applications such as <c>Kopete</c> (Multi-Protocol Instant + Messaging), <c>kppp</c> (Dial-In) and <c>KSirc</c> (IRC client). Note that + <c>konqueror</c> (File Manager <e>and</e> Browser) is part of <c>kdebase</c>! </ti> </tr> <tr> @@ -236,6 +237,14 @@ terminal), <c>kfloppy</c> (Floppy-related actions), etc. </ti> </tr> +<tr> + <ti>kde-i18n</ti> + <ti> + Internationalization files for KDE. This includes translated + documentation. See also the <uri link="http://i18n.kde.org";>KDE i18n + project</uri> for more information. + </ti> +</tr> </table> <p> @@ -248,20 +257,26 @@ </pre> <p> -In case you wonder: compiling KDE does take a while :) +In case you wonder: compiling KDE does take a while. </p> </body> </section> <section> -<title>Installing KDE >= 3.4</title> <!-- TODO rename to "Installing KDE" --> +<title>Installing KDE as Split Packages</title> <body> <p> -More recent KDE versions (from 3.4 onwards) are presented as a plethora of -<uri link="/doc/en/kde-split-ebuilds.xml">split ebuilds</uri>, 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 <uri +link="/doc/en/kde-split-ebuilds.xml">Split Ebuilds HOWTO</uri>. +</p> + +<p> +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: </p> <ul> @@ -292,24 +307,16 @@ <th>Description</th> </tr> <tr> - <ti><c>amarok</c></ti> + <ti><c>akregator</c></ti> <ti> - With <uri link="http://amarok.kde.org/";>amaroK</uri> you have a powerful - music player for Unix/Linux. + The application to easily manage and browse internet RSS feeds. </ti> </tr> <tr> - <ti><c>k3b</c></ti> + <ti><c>juk</c></ti> <ti> - <uri link="http://www.k3b.org/";>K3B</uri> is a complete CD/DVD burning - utility with Audio support. Burning CDs was never this easy. - </ti> -</tr> -<tr> - <ti><c>kaffeine</c></ti> - <ti> - <uri link="http://kaffeine.sourceforge.net/";>Kaffeine</uri> is a full - featured multimedia-player for KDE. + The playlist oriented media player, with a look and feel resembling Apple's + iTunes. </ti> </tr> <tr> @@ -348,6 +355,12 @@ </ti> </tr> <tr> + <ti><c>knode</c></ti> + <ti> + KNode is the powerful KDE newsreader. + </ti> +</tr> +<tr> <ti><c>konqueror</c></ti> <ti> With <uri link="http://konqueror.kde.org/";>Konqueror</uri> you have a @@ -413,7 +426,7 @@ </table> <p> -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 <uri link="http://packages.gentoo.org/packages/?category=kde-base";>kde-base category</uri>. Their function should be available in the description. @@ -432,21 +445,60 @@ <p> If you are happy with the proposed result, leave the <c>-p</c> 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. </p> +</body> +</section> +<section> +<title>External KDE applications</title> +<body> + <p> -If you want KDE to auto-mount your devices you'll need to install <c>dbus</c>, -<c>hal</c> and <c>ivman</c> 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. </p> -<pre caption="Setup auto-mounting"> -# <i>emerge dbus hal ivman</i> -# <i>rc-update add dbus default</i> -# <i>rc-update add hald default</i> -# <i>rc-update add ivman default</i> -</pre> +<table> +<tr> + <th>Ebuild name</th> + <th>Description</th> +</tr> +<tr> + <ti><c>koffice</c></ti> + <ti> + <uri link="http://www.koffice.org/";>KOffice</uri> 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 <c>kde</c> or <c>kde-meta</c> + ebuilds, you can install KOffice as a single package (<c>koffice</c>) or as + a set of individual packages (<c>koffice-meta</c>). + </ti> +</tr> +<tr> + <ti><c>amarok</c></ti> + <ti> + With <uri link="http://amarok.kde.org/";>amaroK</uri> you have a powerful + music player for Unix/Linux. + </ti> +</tr> +<tr> + <ti><c>k3b</c></ti> + <ti> + <uri link="http://www.k3b.org/";>K3B</uri> is a complete CD/DVD burning + utility with Audio support. Burning CDs was never this easy. + </ti> +</tr> +<tr> + <ti><c>kaffeine</c></ti> + <ti> + <uri link="http://kaffeine.sourceforge.net/";>Kaffeine</uri> is a full + featured multimedia-player for KDE. + </ti> +</tr> +</table> </body> </section> @@ -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. </p> @@ -596,7 +648,7 @@ </pre> <p> -Finish up by adding <c>xdm</c> to the default run level: +Finish up by adding <c>xdm</c> to the default runlevel: </p> <pre caption="Adding xdm to the default runlevel"> @@ -616,8 +668,137 @@ </body> </section> +<section id="kde_device_mounting"> +<title>Setup KDE to Mount Devices</title> +<body> + +<p> +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 <c>hal</c> in your USE variable and to have +<c>dbus</c>, <c>hal</c> and <c>pmount</c> installed on your system. You should +also add <c>dbus</c> and <c>hal</c> to the default runlevel and add yourself to +the <c>plugdev</c> group. +</p> + +<pre caption="Setup device mounting"> +# <i>emerge --noreplace dbus hal pmount</i> +# <i>rc-update add dbus default</i> +# <i>rc-update add hald default</i> +<comment>Add <user> to the plugdev group</comment> +# <i>gpasswd -a <user> plugdev</i> +</pre> + +<p> +You can also have your devices automatically mounted without interaction, you +just need to install <c>ivman</c> and add it to the default runlevel. +</p> + +<pre caption="Setup auto-mounting"> +# <i>emerge --noreplace ivman</i> +# <i>rc-update add ivman default</i> +</pre> + +</body> +</section> </chapter> +<chapter> +<title>Managing KDE Installations</title> +<section> +<title>Multiple Installations</title> +<body> + +<p> +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 <path>/usr/kde/3.4/</path> and +the other in <path>/usr/kde/3.5/</path>. +</p> +<p> +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 <path>/home/<user>/.kde3.4</path>, and the first time you run +KDE 3.5 a directory named <path>/home/<user>/.kde3.5</path> will be +created by migrating the settings in the 3.4 directory and will be then used to +store preferences and data. +</p> + +<p> +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 <c>koffice</c>, <c>amarok</c> or <c>k3b</c>) 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. +</p> + +</body> +</section> +<section> +<title>Unmerging Old Versions</title> +<body> + +<p> +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 <c>emerge --unmerge kde</c> you will +not remove the actual kde packages. +</p> + +<p> +To remove a KDE installation (e.g. KDE 3.4), the single packages have to be +removed. +</p> + +<pre caption="Removing KDE 3.4 packages"> +# <i>emerge --unmerge =arts-3.4* =kdelibs-3.4* =kdebase-3.4* ...</i> +</pre> + +<p> +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. +</p> + +<p> +First we list all the packages that we want to remove. +</p> + +<pre caption="Listing packages to remove"> +<comment>(List all the installed KDE packages)</comment> +# <i>equery list kde-base/</i> +<comment>(List all the installed KDE packages and select the ones from KDE 3.4)</comment> +# <i>equery list kde-base/ | grep 3.4</i> +</pre> + +<p> +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 <c>emerge --unmerge</c> command. +</p> + +<pre caption="Removing selected packages"> +# <i>equery list kde-base/ | grep 3.4 | xargs emerge --unmerge --pretend</i> +</pre> + +<p> +Check again the output and reissue the command without <c>--pretend</c> to +start the unmerging process. +</p> + +<p> +After the job has completed, the directory <path>/usr/kde/3.4/</path> 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 +<path>/usr/kde/3.4/</path> with its content to remove what remains of KDE 3.4. +</p> + +</body> +</section> +</chapter> <chapter> <title>Frequently Asked Questions</title> <section> @@ -651,15 +832,6 @@ <comment>(...)</comment> </pre> -<p> -If you don't have an IPv6-enabled network, disable KDE's IPv6 checking by -adding the following line to <path>/etc/env.d/99kde-env</path>: -</p> - -<pre caption="Changing /etc/env.d/99kde-env"> -KDE_NO_IPV6 = 1 -</pre> - </body> </section> </chapter> -- [email protected] mailing list
