** Description changed:

- The libvirt package contains debian/libvirt-daemon.README.Debian which
- contains important information, namely that the libvirtd group is root
- equivalent.
+ [ Impact ]
  
- While the file gets installed in focal and jammy by the libvirt-daemon
- package, it looks like it's no longer getting installed in noble and up.
+  * The libvirt source package contains debian/libvirt-
+ daemon.README.Debian which contains important information, namely that
+ the libvirtd group is root equivalent.
+ 
+  * While the file gets properly installed in Focal and Jammy by the
+ libvirt-daemon package (as well as Plucky and above via a symlink to the
+ new libvirt-common docs), it looks like it does not get installed in
+ Noble and Oracular.
+ 
+  * Up until Jammy libvirt-daemon had a dedicated debian/libvirt-
+ daemon.docs files, which made dh_installdocs pick up the d/libvirt-
+ daemon.README.Debian file automatically and install it in the
+ corresponding usr/share/doc/ directory. But afterwards docs were moved
+ into the libvirt0 binary package and libvirt-daemon.README.Debian was
+ forgotten.
+ 
+ 
+  * Starting in 10.10.0-4 (Plucky and above) docs were moved to a new 
libvirt-common package and the README was renamed to 
libvirt-common.README.Debian: 
+ 
+  * We're applying a similar approach here, but moving it to libvirt0, as
+ that is where the symlinks are pointing to in Noble & Oracular.
+ 
+ [ Test Plan ]
+ 
+  * Install the package from -proposed
+ 
+  * ls -la /usr/share/doc/libvirt0/README.Debian.gz  # original
+  * ls -la /usr/share/doc/libvirt-daemon/README.Debian.gz  # via 
usr/share/docs/libvirt0/ symlink
+  * ls -la /usr/share/doc/libvirt-daemon-system/README.Debian.gz  # via 
usr/share/docs/libvirt0/ symlink
+ 
+  * Make sure all of those files exist and contain the same content (e.g.
+ sha256sum)
+ 
+ [ Where problems could occur ]
+ 
+  * Regression potential is minimal
+  * We're installing a file via dh_installdocs auto-detection (by package 
name).
+  * A typo could make the file not be installed at all (as it is right now).
+ 
+ [ Other Info ]
+ 
+  * Debian change: https://salsa.debian.org/libvirt-
+ team/libvirt/-/commit/e09852843c703ba3534da3c1174d5bf0f0d339ce

-- 
You received this bug notification because you are a member of Ubuntu
Bugs, which is subscribed to Ubuntu.
https://bugs.launchpad.net/bugs/2108995

Title:
  README.Debian file not being installed

To manage notifications about this bug go to:
https://bugs.launchpad.net/ubuntu/+source/libvirt/+bug/2108995/+subscriptions


-- 
ubuntu-bugs mailing list
[email protected]
https://lists.ubuntu.com/mailman/listinfo/ubuntu-bugs

Reply via email to