src/40_install.pod: note about pkgutils backward compatibility upgrade

zeppe-lin · Oct 28, 2023 · 43ee9df · 43ee9df
1 parent d68269e
commit 43ee9df
Showing 1 changed file with 8 additions and 2 deletions.
diff --git a/src/40_install.pod b/src/40_install.pod
@@ -334,8 +334,14 @@ collection is enabled.  Also, you may like to edit F</etc/pkgmk.conf>
 
 =head4 Update the core packages and configuration files
 
-It's highly recommended to update C<core> packages and configuration
-files before the next step:
+B<Note>: Starting from version C<6.0>, C<pkgutils> has broken backward
+compatibility when generating footprint files.  So, at the beginning
+it is recommended to update C<pkgmk> and C<pkgutils>:
+
+    (chrooted) # pkgman update -f pkgmk pkgutils
+
+Now, it's highly recommended to update C<core> packages and
+configuration files before the next step:
 
     (chrooted) # pkgman sysup --deps --depsort --group
     (chrooted) # rejmerge