[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

[RFR] templates://kde4libs/{kdelibs5.templates}



Please find, for review, the debconf templates and packages descriptions for the kde4libs source package.

This review will last from Saturday, October 17, 2009 to Tuesday, October 27, 2009.

Please send reviews as unified diffs (diff -u) against the original
files. Comments about your proposed changes will be appreciated.

Your review should be sent as an answer to this mail.

When appropriate, I will send intermediate requests for review, with
"[RFRn]" (n>=2) as a subject tag.

When we will reach a consensus, I send a "Last Chance For
Comments" mail with "[LCFC]" as a subject tag.

Finally, the reviewed templates will be sent to the package maintainer
as a bug report, and a mail will be sent to this list with "[BTS]" as
a subject tag.

Rationale:
--- kde4libs.old/debian/kdelibs5.templates	2009-10-08 14:48:45.688656288 +0200
+++ kde4libs/debian/kdelibs5.templates	2009-10-12 22:25:35.766828119 +0200
@@ -7,26 +7,17 @@
 Default: true
 _Description: Stop possible unsafe upgrade of KDE4 with running sessions?
  You are about to upgrade to the new version of the kdelibs5 package which
- introduces a major configuration change. Newly started KDE 4 applications
- will use ~/.kde directory to store user settings and data (also known as
- KDEHOME) by default while currently running KDE 4 applications use ~/.kde4.
- KDE 3 applications have always used (and will continue to use) ~/.kde. It
- seems that there are a few KDE 4 applications running on your system at the
- moment. To avoid potential setting/data loss, you should:
+ introduces a major configuration change. Details are given in 
+ /usr/share/doc/kdelibs5/README.Debian: in short, user settings are moved
+ from ~/.kde to ~/.kde4.
  .
- 1) Answer "Yes", terminate all KDE applications and KDE sessions and try
+ Some KDE 4 applications are currently running (${apps}). It is recommended
+ to abort the upgrade of kdelibs5, terminate all KDE applications and KDE sessions and try
  upgrading again.
  .
- or 2) Answer "No" to continue upgrading. You should make sure that no new
- KDE 4 applications are started before you migrate your KDE 4 settings and
- data.  Beware, that clean termination of the old KDE 4 session might not be
- safe..
- .
- Once upgrade is complete, login to KDE as usual or you may use Kaboom wizard
- (package name: kaboom) to migrate your user settings and data before starting
- any KDE 4 application.
- .
- Currently running KDE 4 applications: ${apps}
+ If you choose to coontinue the upgrade, you should make sure that no new
+ KDE 4 applications are started before KDE 4 settings and data are migrated.
+ A clean termination of the old KDE 4 session might not be safe.

The original template was way too long and was trying to say too many
things. It generally triggers more problems than it solves.

Also, the original template was making references to specific aspects
of the interface ('Yes' and 'No' answers) that may vary depending on
the debconf interface and locale settings.

So, I rewrote the template entirely, trying to say the same important
information in a shorter way.

I indeed propose moving the gory details about ~/.kde and ~/.kde4 in a
README.Debian file.
 
 Template: kdelibs5/upgrade_kdehome_info_title
 Type: title
@@ -40,7 +31,7 @@
  KDE 4 applications use ~/.kde4. KDE 3 applications has always used (and will
  continue to use) ~/.kde.
  .
- When upgrade is complete, it is safe to login to KDE as usual or, if you are
+ When the upgrade is complete, it is safe to login to KDE as usual or, if you are
  only using individual KDE 4 applications, you may use Kaboom (available in the
- package of the same name) wizard to migrate your user data before starting a
+ package of the same name) wizard to migrate user data before starting a
  KDE 4 application.

Add missing article.

Drop "your": the user doing the upgrade is not necessarily owning the
data.

PS: I did not review packages descriptions in debian/control.

-- 


Template: kdelibs5/upgrade_kdehome_running_title
Type: title
_Description: Upgrading kdelibs5 while KDE 4 is running

Template: kdelibs5/upgrade_kdehome_running
Type: boolean
Default: true
_Description: Stop possible unsafe upgrade of KDE4 with running sessions?
 You are about to upgrade to the new version of the kdelibs5 package which
 introduces a major configuration change. Details are given in 
 /usr/share/doc/kdelibs5/README.Debian: in short, user settings are moved
 from ~/.kde to ~/.kde4.
 .
 Some KDE 4 applications are currently running (${apps}). It is recommended
 to abort the upgrade of kdelibs5, terminate all KDE applications and KDE sessions and try
 upgrading again.
 .
 If you choose to coontinue the upgrade, you should make sure that no new
 KDE 4 applications are started before KDE 4 settings and data are migrated.
 A clean termination of the old KDE 4 session might not be safe.

Template: kdelibs5/upgrade_kdehome_info_title
Type: title
_Description: Upgrading kdelibs5

Template: kdelibs5/upgrade_kdehome_info
Type: note
_Description: New user settings directory (KDEHOME) for KDE 4 applications
 Once this package is upgraded, KDE 4 applications will use ~/.kde directory to
 store user settings and data (also known as KDEHOME) by default.  Currently,
 KDE 4 applications use ~/.kde4. KDE 3 applications has always used (and will
 continue to use) ~/.kde.
 .
 When the upgrade is complete, it is safe to login to KDE as usual or, if you are
 only using individual KDE 4 applications, you may use Kaboom (available in the
 package of the same name) wizard to migrate user data before starting a
 KDE 4 application.
--- kde4libs.old/debian/kdelibs5.templates	2009-10-08 14:48:45.688656288 +0200
+++ kde4libs/debian/kdelibs5.templates	2009-10-12 22:25:35.766828119 +0200
@@ -7,26 +7,17 @@
 Default: true
 _Description: Stop possible unsafe upgrade of KDE4 with running sessions?
  You are about to upgrade to the new version of the kdelibs5 package which
- introduces a major configuration change. Newly started KDE 4 applications
- will use ~/.kde directory to store user settings and data (also known as
- KDEHOME) by default while currently running KDE 4 applications use ~/.kde4.
- KDE 3 applications have always used (and will continue to use) ~/.kde. It
- seems that there are a few KDE 4 applications running on your system at the
- moment. To avoid potential setting/data loss, you should:
+ introduces a major configuration change. Details are given in 
+ /usr/share/doc/kdelibs5/README.Debian: in short, user settings are moved
+ from ~/.kde to ~/.kde4.
  .
- 1) Answer "Yes", terminate all KDE applications and KDE sessions and try
+ Some KDE 4 applications are currently running (${apps}). It is recommended
+ to abort the upgrade of kdelibs5, terminate all KDE applications and KDE sessions and try
  upgrading again.
  .
- or 2) Answer "No" to continue upgrading. You should make sure that no new
- KDE 4 applications are started before you migrate your KDE 4 settings and
- data.  Beware, that clean termination of the old KDE 4 session might not be
- safe..
- .
- Once upgrade is complete, login to KDE as usual or you may use Kaboom wizard
- (package name: kaboom) to migrate your user settings and data before starting
- any KDE 4 application.
- .
- Currently running KDE 4 applications: ${apps}
+ If you choose to coontinue the upgrade, you should make sure that no new
+ KDE 4 applications are started before KDE 4 settings and data are migrated.
+ A clean termination of the old KDE 4 session might not be safe.
 
 Template: kdelibs5/upgrade_kdehome_info_title
 Type: title
@@ -40,7 +31,7 @@
  KDE 4 applications use ~/.kde4. KDE 3 applications has always used (and will
  continue to use) ~/.kde.
  .
- When upgrade is complete, it is safe to login to KDE as usual or, if you are
+ When the upgrade is complete, it is safe to login to KDE as usual or, if you are
  only using individual KDE 4 applications, you may use Kaboom (available in the
- package of the same name) wizard to migrate your user data before starting a
+ package of the same name) wizard to migrate user data before starting a
  KDE 4 application.
Source: kde4libs
Section: libs
Priority: optional
Maintainer: Debian Qt/KDE Maintainers <debian-qt-kde@lists.debian.org>
Uploaders: Ana Beatriz Guerrero Lopez <ana@debian.org>, Sune Vuorela <debian@pusling.com>, Fathi Boudra <fabo@debian.org>, Armin Berres <armin+debian@space-based.de>, Modestas Vainius <modestas@vainius.eu>, George Kiagiadakis <gkiagiad@csd.uoc.gr>
Build-Depends: cdbs (>= 0.4.51), debhelper (>= 7.2.3), quilt, cmake (>= 2.6.3), pkg-kde-tools (>= 0.4.2), po-debconf,
 shared-mime-info (>= 0.20), dpkg-dev (>= 1.15.3), libphonon-dev (>= 4:4.3.0),
 libcups2-dev, libdbus-1-dev, libqt4-dev (>= 4.5.1), libqt4-opengl-dev (>= 4.5.1),
 libasound2-dev [!kfreebsd-i386 !kfreebsd-amd64 !hurd-i386],
 libkeyutils-dev [!kfreebsd-i386 !kfreebsd-amd64 !hurd-i386],
 libpng-dev, libssl-dev, libsm-dev, flex, bison,
 libsoprano-dev (>= 2.3.0), libstreamanalyzer-dev (>= 0.6.3),
 libxml2-dev, libxml2-utils,  libxslt1-dev, libxtst-dev, libgif-dev,
 libavahi-common-dev, libaspell-dev, libbz2-dev, libenchant-dev, libfam-dev,
 libjasper-dev, libopenexr-dev, libpcre3-dev, libtiff4-dev, hspell, xsltproc,
 libglu1-mesa-dev, libenchant-dev, libacl1-dev, automoc (>= 1.0~version-0.9.88),
 libxcursor-dev, libutempter-dev
Standards-Version: 3.8.3
Homepage: http://www.kde.org/
Vcs-Browser: http://svn.debian.org/wsvn/pkg-kde/trunk/packages/kdelibs
Vcs-Svn: svn://svn.debian.org/pkg-kde/trunk/packages/kdelibs

Package: kdelibs5
Architecture: any
Depends: ${shlibs:Depends}, kdelibs5-data (>= ${source:Version}),
 kdelibs-bin(>= ${binary:Version}), dbus-x11, shared-mime-info, xauth, xdg-utils
Pre-Depends: debconf | debconf-2.0
Recommends: ttf-dejavu, kdebase-runtime (>= 4:4.2.95), kaboom (>= 1.0.5)
Conflicts: kdebase-workspace-libs4+5 (<< 4.2.2), kdepimlibs5 (<< 4.2.2)
Replaces: kdelibs-bin (<< 4:4.1.74)
Suggests: hspell
Description: core libraries for all KDE 4 applications
 This package contains shared libraries needed to run KDE 4 applications.
 .
 This package is part of the KDE 4 libraries module.

Package: kdelibs5-data
Architecture: all
Depends: hicolor-icon-theme
Replaces: kdebase-workspace-data (<< 4:4.1.66), libplasma2, kjscmd (<< 4:3.5.10-1)
Conflicts: kjscmd (<< 4:3.5.10-1)
Description: core shared data for all KDE 4 applications
 This package contains architecture-independent data files needed to run KDE 4
 applications.
 .
 This package is part of the KDE 4 libraries module.

Package: kdelibs5-dev
Section: libdevel
Architecture: any
Depends: ${shlibs:Depends}, kdelibs5 (= ${binary:Version}), libplasma3 (= ${binary:Version}),
 cmake (>= 2.6.2-3~), automoc (>= 1.0~svn850570), pkg-kde-tools (>= 0.4.2),
 ${sameVersionDep:libqt4-dev}, ${sameVersionDep:libsoprano-dev}, ${sameVersionDep:libphonon-dev}
#Suggests: kdelibs5-doc (= ${source:Version})
Recommends: ${sameVersionDep:libqt4-opengl-dev:libplasma3-Depends}
Replaces: kdebase-runtime-data (<< 4:4.2.90), kdelibs5-data (<< 4:4.0.80-1), libplasma-dev (<< 4:4.1.96),
 kdebase-workspace-dev (<< 4:4.2.90)
Conflicts: kdelibs4-dev, libkjsembed-dev, kdepimlibs5-dev (<< 4:4.1.81+svn891439), libplasma-dev (<< 4:4.1.96)
Provides: libplasma-dev
Description: development files for the KDE 4 core libraries
 This package contains development files for building KDE 4 applications and
 other software that uses the KDE 4 libraries.

#Package: kdelibs5-doc
#Section: doc
#Architecture: all
#Provides: kdelibs-doc
#Description: developer documentation for the KDE 4 core libraries
# This package contains the API documentation for the KDE core libraries,
# for use by KDE 4 application developers.
# .
# This package is part of the KDE 4 libraries module.

Package: kdelibs-bin
Architecture: any
Depends: ${shlibs:Depends}, kdelibs5 (= ${binary:Version}), libxml2-utils
Conflicts: kjscmd
Description: executables for all KDE 4 core applications
 This package contains common executables used by all KDE 4 applications.
 .
 This package is part of the KDE 4 libraries module.

Package: libplasma3
Architecture: any
Depends: ${shlibs:Depends}, ${misc:Depends}, kdelibs5-data (= ${source:Version})
Breaks: kdebase-workspace-bin (<< 4:4.2.60)
Description: library for the KDE 4 Plasma desktop
 Plasma is one of the key technologies of KDE 4 (also known as the "Pillars
 of KDE"), and one of the most visible to users. It is the component that
 is "in charge" of the desktop interface; the desktop, panel (often referred
 simply as the task bar), and related elements. Plasma aims to change the
 traditional concepts of the "Desktop", incorporating semantic application
 elements, and bringing cooperating technologies to the user's fingertips in
 a way that is visually appealing while easing work flow.
 .
 This package contains the KDE 4 Plasma library. It is part of the KDE 4
 libraries module.

Package: kdelibs5-dbg
Section: debug
Architecture: any
Priority: extra
Depends: kdelibs5 (= ${binary:Version}), libqt4-dbg (>= 4.4.3), libc6-dbg [amd64]
Recommends: libplasma3 (= ${binary:Version})
Description: debugging symbols for the KDE 4 libraries module
 This package contains debugging files used to investigate problems with
 binaries included in the KDE 4 libraries module.

Attachment: signature.asc
Description: Digital signature


Reply to: