Document older downgrade conversion _after_ installation

1 files changed, 18 insertions, 0 deletions

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) = @_;