From 278b88dcff6304bb3d86040975bbc72f3655338f Mon Sep 17 00:00:00 2001
From: Thierry Vignaud <thierry.vignaud@gmail.com>
Date: Sat, 5 Jun 2021 12:38:49 +0200
Subject: Document older downgrade conversion _after_ installation

---
 urpm/sys.pm | 18 ++++++++++++++++++
 1 file changed, 18 insertions(+)

diff --git a/urpm/sys.pm b/urpm/sys.pm
index d8da722a..bffb7ced 100644
--- a/urpm/sys.pm
+++ b/urpm/sys.pm
@@ -248,6 +248,12 @@ sub print_need_restart() {
     print "$_\n" foreach values %$h;
 }
 
+=item migrate_back_rpmdb_db_to_4_6($urpm, $root)
+
+Downgrade rpmdb from  external libdb-4.6.so to internal DB 4.3.27 (mdv2008.1 -> mdv2009.0)
+
+=cut
+
 sub migrate_back_rpmdb_db_to_hash_8 {
     my ($urpm, $root) = @_;
 
@@ -266,6 +272,12 @@ sub migrate_back_rpmdb_db_to_hash_8 {
     }
 }
 
+=item migrate_back_rpmdb_db_to_4_6($urpm, $root)
+
+Downgrade rpmdb from rpm-4.9 to 4.8.1 (both linked with db4.8.30) db (eg: when installing mga1 in a chroot from mga2+, mga#4590)
+
+=cut
+
 sub migrate_back_rpmdb_db_to_4_6 {
     my ($urpm, $root) = @_;
     $urpm->{info}("migrating back the created rpm db from rpm-4.9 to rpm-4.6/4.8");
@@ -276,6 +288,12 @@ sub migrate_back_rpmdb_db_to_4_6 {
     }
 }
 
+=item migrate_back_rpmdb_db_version($urpm, $root)
+
+Check if we need to migrate back rpmdb to an older libdb after completing the upgrade/installation.
+
+=cut
+
 sub migrate_back_rpmdb_db_version {
     my ($urpm, $root) = @_;
 
-- 
cgit v1.2.1