View source for Kde4 Plasma5 Upgrade

{{warning|This page is under development. [[User:Tassietux|Tassietux]] ([[User talk:Tassietux|talk]]) 05:51, January 31, 2017 (MST)}}
'''KDE Plasma 4 development and support has ceased. KDE Plasma 4 ebuilds are currently masked upstream and are due to be removed from the Portage tree during February 2017'''.

'''This change will affect Funtoo Linux'''.

Plasma 4 was the graphical environment that formed part of the former '''KDE SC 4''' (KDE Software Compilation 4). Plasma 5 is the current graphical environment offered by KDE. Many of the KDE Applications available under KDE SC 4 continue to be available under Plasma 5.

The purpose of this page is to detail the steps required to migrate Funtoo Linux from KDE SC 4 (Plasma 4) to [[KDE Plasma 5]] and KDE Applications. Given incompatibilities between Plasma 4 and Plasma 5 packages, Users undertaking this process are likely to encounter one or more blockers. Users are encouraged to seek assistance in the #funtoo IRC channel on Freenode.

__TOC__

== Update Funtoo Profiles ==
Changes to Funtoo [[Funtoo_Profiles#Mix-ins|mix-in]] Profiles are required for KDE Plasma 5. Review the selected profiles using [[Funtoo_Profiles#Using_epro|epro]].

{{console|body=
###i## epro show

=== ##g##Enabled Profiles##!g##: ===

        arch: ##bl##x86-64bit##!bl##
       build: ##bl##current##!bl##
     subarch: ##bl##intel64-haswell##!bl##
      flavor: ##bl##desktop##!bl##
     mix-ins: ##bl##kde##!bl##

}}

There are two KDE-related mix-ins available in Funtoo: ''kde'' and ''kde-plasma-5''. To migrate to KDE Plasma 5, users must remove the ''kde'' mix-in and add the ''kde-plasma-5'' mix-in.

DO NOT combine ''kde'' and ''kde-plasma-5'' at the same time - they are incompatible.

{{console|body=
###i## epro mix-in -kde +kde-plasma-5

=== ##g##Enabled Profiles##!g##: ===

        arch: ##bl##x86-64bit##!bl##
       build: ##bl##current##!bl##
     subarch: ##bl##intel64-haswell##!bl##
      flavor: ##bl##desktop##!bl##
     mix-ins: ##bl##kde-plasma-5##!bl##

>>> Removed kde mix-in.
>>> Added kde-plasma-5 mix-in.
}}

== Review USE Flags ==
To achieve clean update it is necessary to review <code>/etc/portage/package.use</code>, <code>/etc/portage/make.conf</code> for a kde sc4 specific USE's. Having this USE flags enabled globally or per package base may clash with default kde-plasma-5 mix-ins settings and may result in certain difficulties with update, such as ebuild blocks.

Following command will scan your <code>/etc/portage/make.conf</code>
{{console|body=
###i## grep -e "qt[[:digit:]]" -e "handbook" -e "kde" -e "plasma" /etc/portage/make.conf
}}
It is necessary to review these USE's, if set.
Next commands will scan your <code>/etc/portage/package.use</code>

{{console|body=
###i## grep -e "qt[[:digit:]]$" -e "qt[[:digit:]] " -e "handbook$" -e "handbook " -R /etc/portage/package.use
###i## grep -e "kde$" -e "kde " -e "plasma$" -e "plasma " -R /etc/portage/package.use
}}
Like above it's needed to review USEs, if set.
== Cleaning world ==
When explicitly installed and recorded into <code>/var/lib/portage/world</code> KDE SC 4 ebuilds can block updates to Plasma 5. To examine presence of such ebuilds in world file, please try following command

<console>
# for x in libkscreen kde-gtk-config ksshaskpass freespacenotifier kcheckpass kcminit kdebase-cursors kdebase-startkde kdm kephal khotkeys kinfocenter klipper kmenuedit krunner kscreensaver ksmserver ksplash kstartupconfig kstyles ksysguard ksystraycmd kwin kwrited libkgreeter libkworkspace liboxygenstyle libplasmaclock libplasmagenericshell libtaskmanager plasma-workspace powerdevil qguiplatformplugin_kde solid-actions-kcm systemsettings; do equery -q d ${x} | sed -e "s/-[0-9].*//"; done | sed -e "/kdebase-meta/g" -e "/kde-meta/g" | xargs emerge --deselect --pretend
</console>
When reviewed, this command can be performed without --pretend to clean world.

== Emerge KDE Plasma 5 and KDE Applications ==

As everyone used to install KDE SC4 by their choices, Plasma 5 also modular and differs from bare minimal installation to more feature rich desktop.
<code>kde-plasma/plasma-meta</code> is a package name for a complete desktop. In turn, if decided to install only minimal basic installation, <code>kde-plasma/plasma-dekstop</code> is your choice:
{{console|body=
###i## emerge -av  kde-plasma/plasma-meta
}}
or
{{console|body=
###i## emerge -av  kde-plasma/plasma-desktop
}}

== Configure and Start Plasma 5 ==
=== SSH and GPG Agent Scripts ===

Details pending.

=== KDE Plasma 5 Display (Login) Manager ===
{{warning|This section is incomplete.}}
The default [https://en.wikipedia.org/wiki/X_display_manager_(program_type) Display Manager] for KDE Plasma 4 was KDM (kde-base/kdm). This has been

To change from KDM to SDDM, edit {{f|/etc/conf.d/xdm}} with your favorite editor, updating the DISPLAYMANAGER entry to equal 'sddm'

{{file|name=/etc/conf.d/xdm|body=
DISPLAYMANAGER="sddm"
}}

Configure SDDM...

Start SDDM...

=== Migrate KWallet ===

Details pending.

== Troubleshooting and Further Reading ==

[https://wiki.gentoo.org/wiki/KDE/Plasma_5_upgrade Gentoo Linux KDE Plasma 5 Upgrade]

[[Category:Desktop]]