[Pkg-owncloud-maintainers] Bug#757762: owncloud-client: Confusing NEWS.Debian entry

[Gaudenz Steinlin]

Package: owncloud-client
Version: 1.6.2+dfsg-1
Severity: normal

In default installations apt-listchanges is installed and configured to
show NEWS entries without asking for confirmation. Because of this it's
important that these entries understandable to the average user of a
package and offer advice on how to solve the described problems.

The NEWS.Debian entry for version 1.6.0~beta1+dfsg-1 is quite confusing
because it does not offer any solution to the described problems and the
nature and implications of the problem are quite unclear (at least to
me).

Guessing from what's not really spelled out in the text but probably
implied, the problem seems to be that all client settings are reset or 
appear to be reset. Is this correct?

I could not verify this because at least for me when upgrading from 
1.5.0+dfsg-4 to 1.6.2+dfsg-1 the problem did not show up. All settings
were preserved and I did not see the setup wizard again.

Please also add clear instructions on how to remedy the situation.
Including on how to abort updating if not all required credentials are
known. At least in the default configuration apt-listchanges does not
offer the option to abort the installation.

The current english text reads quite bumpy. Some suggestions to improve
the wording. This is based on my understanding of what's happening. It
may be wrong. I'm not a native english speaker either, so best let your
your final wording review by someone on the
debian-i10l-english at lists.debian.org mailinglist. This list was created
to aid everyone review their user visible texts like NEWS entries and
debconf templates.

----
After upgrading from version 1.5.X all settings can be reset and the
setupWizard may be shown again. This happens if XXXX.

  * Make sure you know your OwnCloud password as you will be required to
    enter it again.
  * While all settings are reset, synchronization will continue in the
    background without any visual feedback. If needed you can check this
    in the log window.
----

Thanks for maintaining and improving owncloud-client!

Gaudenz

-- System Information:
Debian Release: jessie/sid
  APT prefers testing
  APT policy: (500, 'testing'), (100, 'unstable'), (1, 'experimental')
Architecture: amd64 (x86_64)

Kernel: Linux 3.14-2-amd64 (SMP w/4 CPU cores)
Locale: LANG=en_US.UTF-8, LC_CTYPE=en_US.UTF-8 (charmap=UTF-8)
Shell: /bin/sh linked to /bin/dash

Versions of packages owncloud-client depends on:
ii  libc6                 2.19-7
ii  libgcc1               1:4.9.1-4
ii  libowncloudsync0      1.6.2+dfsg-1
ii  libqt5core5a          5.3.1+dfsg-3
ii  libqt5dbus5           5.3.1+dfsg-3
ii  libqt5gui5            5.3.1+dfsg-3
ii  libqt5network5        5.3.1+dfsg-3
ii  libqt5sql5-sqlite     5.3.1+dfsg-3
ii  libqt5widgets5        5.3.1+dfsg-3
ii  libqt5xml5            5.3.1+dfsg-3
ii  libstdc++6            4.9.1-4
ii  owncloud-client-l10n  1.6.2+dfsg-1

owncloud-client recommends no packages.

owncloud-client suggests no packages.

-- no debconf information