[SCM] KDE Base Workspace module packaging branch, squeeze, updated. debian/4.4.5-5-3-gdb49c80

[Modestas Vainius]

The following commit has been merged in the squeeze branch:
commit db49c80ec9aca70c8ff9b749e7553222644c9b40
Author: Modestas Vainius <modestas at vainius.eu>
Date:   Sat Jan 1 22:24:23 2011 +0200

    Document a workaround for the "dark taskbar" bug in README.Debian.
    
    The real fix is in KDE SC 4.5 or later. However, regardless, I think this
    change closes: #564941.
---
 debian/README.Debian |   32 ++++++++++++++++++++++++++++++++
 debian/changelog     |    5 +++++
 2 files changed, 37 insertions(+), 0 deletions(-)

diff --git a/debian/README.Debian b/debian/README.Debian
new file mode 100644
index 0000000..a9a967b
--- /dev/null
+++ b/debian/README.Debian
@@ -0,0 +1,32 @@
+Working around the dark taskbar bug (#564941) in KDE SC 4.4
+-----------------------------------------------------------
+
+If your taskbar sometimes turns black, dark or loses transparency, you've
+probably been hit by #564941. The bug usually occurs with default Plasma theme
+(known as "Air") when compositing (also known as "Desktop Effects") is off or
+when it is suspended with e.g. Ctrl+Shift+F12. The bug is said to be rarer when
+compositing is on or another Plasma theme is used. Refer to [1] and [2] for
+more information.
+
+The bug is triggered by pixmap cache corruption. While there is no real fix for
+it, Plasma in KDE SC 4.5 or later solved it by moving away from KPixmapCache
+class to a new KDE SC 4.5 technology. Therefore, it was not possible to
+backport the real fix to KDE Software Compilation 4.4.5 which Debian Squeeze
+6.0 ships with.
+
+Fortunately, there is a workaround. You can avoid the bug by turning off Plasma
+theme pixmap caching at the expense of performance. Don't be very alarmed
+though, typically slowdown should not be very noticeable. In order to do this,
+add the following two lines:
+
+[CachePolicies]
+CacheTheme=false
+
+to either /etc/kde4/plasmarc (system-wide option) or
+~/.kde/share/config/plasmarc (user-specific option). Alternatively,
+user-specific option can be changed with the following command:
+
+$ kwriteconfig --file plasmarc --group CachePolicies --type bool --key CacheTheme false
+
+[1] http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=564941
+[2] https://bugs.kde.org/show_bug.cgi?id=224666
diff --git a/debian/changelog b/debian/changelog
index fc0c3ce..7c5f5ef 100644
--- a/debian/changelog
+++ b/debian/changelog
@@ -4,6 +4,11 @@ kdebase-workspace (4:4.4.5-6) UNRELEASED; urgency=medium
   * Move the solid servicetypes from kdebase-workspace-bin.install.linux to
     kdebase-workspace-bin.install. (Closes: #608541)
 
+  [ Modestas Vainius ]
+  * Document a workaround for the "dark taskbar" bug in README.Debian. The real
+    fix is in KDE SC 4.5 or later. However, regardless, I think this change
+    closes: #564941.
+
  -- Debian Qt/KDE Maintainers <debian-qt-kde at lists.debian.org>  Sat, 01 Jan 2011 10:36:45 +0100
 
 kdebase-workspace (4:4.4.5-5) unstable; urgency=medium

-- 
KDE Base Workspace module packaging