[gentoo-dev] [PATCH] 2021-10-27-upgrade-to-net-news_rssguard-4_0: add news item

[gentoo-dev] [PATCH] 2021-10-27-upgrade-to-net-news_rssguard-4_0: add news item

[Anna Vyalkova]

Signed-off-by: Anna Vyalkova <cyber+gentoo@sysrq.in>
---
Related to this version bump and unmask:
https://archives.gentoo.org/gentoo-proxy-maint/message/d86352b4ebad8c4ddd14fcd8ce37162f

 ...27-upgrade-to-net-news_rssguard-4_0.en.txt | 29 +++++++++++++++++++
 1 file changed, 29 insertions(+)
 create mode 100644 2021-10-27-upgrade-to-net-news_rssguard-4_0/2021-10-27-upgrade-to-net-news_rssguard-4_0.en.txt

diff --git a/2021-10-27-upgrade-to-net-news_rssguard-4_0/2021-10-27-upgrade-to-net-news_rssguard-4_0.en.txt b/2021-10-27-upgrade-to-net-news_rssguard-4_0/2021-10-27-upgrade-to-net-news_rssguard-4_0.en.txt
new file mode 100644
index 0000000..35971f0
--- /dev/null
+++ b/2021-10-27-upgrade-to-net-news_rssguard-4_0/2021-10-27-upgrade-to-net-news_rssguard-4_0.en.txt
@@ -0,0 +1,29 @@
+Title: net-news/rssguard-4.0 upgrade
+Author: Anna Vyalkova <cyber+gentoo@sysrq.in>
+Posted: 2021-10-27
+Revision: 1
+News-Item-Format: 2.0
+Display-If-Installed: <net-news/rssguard-4.0
+
+RSS Guard database files created by RSS Guard version 3.9.x are
+incompatible with RSS Guard version 4.0 or later [0].
+
+Configuration file (config.ini) is fully backwards compatible according
+to the upstream. You can save it (File -> Backup settings) before an
+upgrade and restore it later (File -> Restore settings).
+
+There is no reliable way to automate the database format conversion, so
+action from the user is required before an upgrade can take place.
+
+The first option would be to export your feeds as an OMPL file
+(Accounts -> Export feeds) before an upgrade and import them later
+(Account -> Import feeds).
+
+The second option would be to manually update your database.db file to
+4.x.x format following a guide by the upstream developer [1].
+
+Keep in mind that application data directory has been renamed from
+"~/.config/RSS Guard" to "~/.config/RSS Guard 4".
+
+[0] https://github.com/martinrotter/rssguard/releases/tag/4.0.0
+[1] https://github.com/martinrotter/rssguard/blob/master/resources/docs/Documentation.md#migratt
-- 
2.33.1

Re: [gentoo-dev] [PATCH] 2021-10-27-upgrade-to-net-news_rssguard-4_0: add news item

[John Helmert III]

[-- Attachment #1: Type: text/plain, Size: 2436 bytes --]

On Wed, Oct 27, 2021 at 10:53:10AM +0500, Anna Vyalkova wrote:
> Signed-off-by: Anna Vyalkova <cyber+gentoo@sysrq.in>
> ---
> Related to this version bump and unmask:
> https://archives.gentoo.org/gentoo-proxy-maint/message/d86352b4ebad8c4ddd14fcd8ce37162f
> 
>  ...27-upgrade-to-net-news_rssguard-4_0.en.txt | 29 +++++++++++++++++++
>  1 file changed, 29 insertions(+)
>  create mode 100644 2021-10-27-upgrade-to-net-news_rssguard-4_0/2021-10-27-upgrade-to-net-news_rssguard-4_0.en.txt
> 
> diff --git a/2021-10-27-upgrade-to-net-news_rssguard-4_0/2021-10-27-upgrade-to-net-news_rssguard-4_0.en.txt b/2021-10-27-upgrade-to-net-news_rssguard-4_0/2021-10-27-upgrade-to-net-news_rssguard-4_0.en.txt
> new file mode 100644
> index 0000000..35971f0
> --- /dev/null
> +++ b/2021-10-27-upgrade-to-net-news_rssguard-4_0/2021-10-27-upgrade-to-net-news_rssguard-4_0.en.txt
> @@ -0,0 +1,29 @@
> +Title: net-news/rssguard-4.0 upgrade
> +Author: Anna Vyalkova <cyber+gentoo@sysrq.in>
> +Posted: 2021-10-27
> +Revision: 1
> +News-Item-Format: 2.0
> +Display-If-Installed: <net-news/rssguard-4.0

Why the version restriction? Seems unecessary to me, especially for
anyone who might completely miss the mask who could upgrade straight
to >=rssguard-4.0 due to when they sync.

> +
> +RSS Guard database files created by RSS Guard version 3.9.x are
> +incompatible with RSS Guard version 4.0 or later [0].
> +
> +Configuration file (config.ini) is fully backwards compatible according
> +to the upstream. You can save it (File -> Backup settings) before an
> +upgrade and restore it later (File -> Restore settings).
> +
> +There is no reliable way to automate the database format conversion, so
> +action from the user is required before an upgrade can take place.
> +
> +The first option would be to export your feeds as an OMPL file
> +(Accounts -> Export feeds) before an upgrade and import them later
> +(Account -> Import feeds).
> +
> +The second option would be to manually update your database.db file to
> +4.x.x format following a guide by the upstream developer [1].
> +
> +Keep in mind that application data directory has been renamed from
> +"~/.config/RSS Guard" to "~/.config/RSS Guard 4".
> +
> +[0] https://github.com/martinrotter/rssguard/releases/tag/4.0.0
> +[1] https://github.com/martinrotter/rssguard/blob/master/resources/docs/Documentation.md#migratt
> -- 
> 2.33.1
> 
> 

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 833 bytes --]

Re: [gentoo-dev] [PATCH] 2021-10-27-upgrade-to-net-news_rssguard-4_0: add news item

[Joonas Niilola]

[-- Attachment #1.1: Type: text/plain, Size: 1898 bytes --]

On 27.10.2021 18.19, John Helmert III wrote:
> On Wed, Oct 27, 2021 at 10:53:10AM +0500, Anna Vyalkova wrote:
>> Signed-off-by: Anna Vyalkova <cyber+gentoo@sysrq.in>
>> ---
>> Related to this version bump and unmask:
>> https://archives.gentoo.org/gentoo-proxy-maint/message/d86352b4ebad8c4ddd14fcd8ce37162f
>>
>>  ...27-upgrade-to-net-news_rssguard-4_0.en.txt | 29 +++++++++++++++++++
>>  1 file changed, 29 insertions(+)
>>  create mode 100644 2021-10-27-upgrade-to-net-news_rssguard-4_0/2021-10-27-upgrade-to-net-news_rssguard-4_0.en.txt
>>
>> diff --git a/2021-10-27-upgrade-to-net-news_rssguard-4_0/2021-10-27-upgrade-to-net-news_rssguard-4_0.en.txt b/2021-10-27-upgrade-to-net-news_rssguard-4_0/2021-10-27-upgrade-to-net-news_rssguard-4_0.en.txt
>> new file mode 100644
>> index 0000000..35971f0
>> --- /dev/null
>> +++ b/2021-10-27-upgrade-to-net-news_rssguard-4_0/2021-10-27-upgrade-to-net-news_rssguard-4_0.en.txt
>> @@ -0,0 +1,29 @@
>> +Title: net-news/rssguard-4.0 upgrade
>> +Author: Anna Vyalkova <cyber+gentoo@sysrq.in>
>> +Posted: 2021-10-27
>> +Revision: 1
>> +News-Item-Format: 2.0
>> +Display-If-Installed: <net-news/rssguard-4.0
> 
> Why the version restriction? Seems unecessary to me, especially for
> anyone who might completely miss the mask who could upgrade straight
> to >=rssguard-4.0 due to when they sync.
> 

(can't speak for the original author, but) I on the other hand liked it
more this way. Since >=4.0 has been available for quite some time
already (package.masked), people might've done the upgrade with the info
available in pkg_postinst(). And then again this news item seems useless
if you never had <4.0 installed anyway.

You should receive a notification about this news item after you sync,
before you world-update. I do prefer it like this, seems a bit clearer,
but no strong opinions either way...

-- juippis


[-- Attachment #2: OpenPGP digital signature --]
[-- Type: application/pgp-signature, Size: 618 bytes --]

Re: [gentoo-dev] [PATCH] 2021-10-27-upgrade-to-net-news_rssguard-4_0: add news item

[Anna Vyalkova]

On 2021-10-27 10:19, John Helmert III wrote:
> > +Display-If-Installed: <net-news/rssguard-4.0
> 
> Why the version restriction? Seems unecessary to me, especially for
> anyone who might completely miss the mask who could upgrade straight
> to >=rssguard-4.0 due to when they sync.

Because users, who have already upgraded to 4.0, had seen ewarn in
pkg_pretend phase:

=> https://gitweb.gentoo.org/repo/gentoo.git/tree/net-news/rssguard/rssguard-4.0.3.ebuild?id=026dfe93d6c7e9a5e5c51dc94d0364bfbf3a6b03#n34