Bug 1881170

Summary: split documentation from the qemu-kvm-core package to its own subpackage
Product: Red Hat Enterprise Linux Advanced Virtualization Reporter: Danilo de Paula <ddepaula>
Component: qemu-kvmAssignee: Danilo de Paula <ddepaula>
qemu-kvm sub component: General QA Contact: FuXiangChun <xfu>
Status: CLOSED ERRATA Docs Contact:
Severity: unspecified    
Priority: unspecified CC: jinzhao, virt-maint, xfu
Version: 8.3Keywords: Documentation, TestOnly, Triaged
Target Milestone: beta   
Target Release: 8.3   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: qemu-kvm-5.1.0-17.module+el8.3.1+9213+7ace09c3 Doc Type: If docs needed, set a value
Doc Text:
Story Points: ---
Clone Of:
: 1924766 (view as bug list) Environment:
Last Closed: 2021-02-22 15:39:38 UTC Type: Bug
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: --- Target Upstream Version:
Embargoed:
Bug Depends On:    
Bug Blocks: 1924766    

Description Danilo de Paula 2020-09-21 17:21:05 UTC
At this moment, qemu's documentation is being shipped within the qemu-kvm-core package (actually, qemu-kvm-common).

Since there's an effort to reduce qemu-kvm's package footprint, this documentation (~6MB of html pages) should be removed from the common package and introduced into a new sub-package so it doesn't get installed automatically with that qemu-kvm-core (but gets installed with qemu-kvm meta pacakge)

Comment 1 Danilo de Paula 2020-09-21 17:24:35 UTC
Marking ITR=8.3.1 and granting devel+

Comment 2 FuXiangChun 2020-09-30 02:03:56 UTC
Currently, can see like this.
#rpm -ql qemu-kvm-common-5.1.0-10.module+el8.3.0+8254+568ca30d.x86_64 |grep html

/usr/share/doc/qemu-kvm/index.html
/usr/share/doc/qemu-kvm/interop/bitmaps.html
/usr/share/doc/qemu-kvm/interop/dbus-vmstate.html
....
/usr/share/doc/qemu-kvm/user/index.html
/usr/share/doc/qemu-kvm/user/main.html
/usr/share/doc/qemu-kvm/user/search.html

#rpm -ql qemu-kvm-common-5.1.0-10.module+el8.3.0+8254+568ca30d.x86_64 |grep txt
/usr/share/doc/qemu-kvm/interop/qemu-ga-ref.txt
/usr/share/doc/qemu-kvm/interop/qemu-qmp-ref.txt
/usr/share/doc/qemu-kvm/qmp-spec.txt

Comment 3 John Ferlan 2020-09-30 12:46:03 UTC
Danilo - I assume since you generated this and understand what need to be done.

Comment 5 Danilo de Paula 2020-12-08 19:38:45 UTC
QA_ACK, please?

Comment 10 FuXiangChun 2020-12-22 05:53:05 UTC
Verified bug with qemu-kvm-common-5.1.0-17.module+el8.3.1+9213+7ace09c3.x86_64.

1. new add package qemu-kvm-docs-5.1.0-17.module+el8.3.1+9213+7ace09c3.x86_64

# rpm -ql qemu-kvm-docs-5.1.0-17.module+el8.3.1+9213+7ace09c3.x86_64 |grep txt
/usr/share/doc/qemu-kvm/interop/qemu-ga-ref.txt
/usr/share/doc/qemu-kvm/interop/qemu-qmp-ref.txt
/usr/share/doc/qemu-kvm/qmp-spec.txt

# rpm -ql qemu-kvm-docs-5.1.0-17.module+el8.3.1+9213+7ace09c3.x86_64 |grep html
/usr/share/doc/qemu-kvm/index.html
/usr/share/doc/qemu-kvm/interop/bitmaps.html
/usr/share/doc/qemu-kvm/interop/dbus-vmstate.html
/usr/share/doc/qemu-kvm/interop/dbus.html
/usr/share/doc/qemu-kvm/interop/genindex.html
/usr/share/doc/qemu-kvm/interop/index.html
/usr/share/doc/qemu-kvm/interop/live-block-operations.html
/usr/share/doc/qemu-kvm/interop/pr-helper.html
/usr/share/doc/qemu-kvm/interop/qemu-ga-ref.html
/usr/share/doc/qemu-kvm/interop/qemu-ga.html
/usr/share/doc/qemu-kvm/interop/qemu-qmp-ref.html
/usr/share/doc/qemu-kvm/interop/search.html
/usr/share/doc/qemu-kvm/interop/vhost-user-gpu.html
/usr/share/doc/qemu-kvm/interop/vhost-user.html
/usr/share/doc/qemu-kvm/interop/vhost-vdpa.html
/usr/share/doc/qemu-kvm/system/arm/aspeed.html
/usr/share/doc/qemu-kvm/system/arm/collie.html
/usr/share/doc/qemu-kvm/system/arm/cpu-features.html
/usr/share/doc/qemu-kvm/system/arm/digic.html
/usr/share/doc/qemu-kvm/system/arm/gumstix.html
/usr/share/doc/qemu-kvm/system/arm/integratorcp.html
/usr/share/doc/qemu-kvm/system/arm/mps2.html
/usr/share/doc/qemu-kvm/system/arm/musca.html
/usr/share/doc/qemu-kvm/system/arm/musicpal.html
/usr/share/doc/qemu-kvm/system/arm/nseries.html
/usr/share/doc/qemu-kvm/system/arm/orangepi.html
/usr/share/doc/qemu-kvm/system/arm/palm.html
/usr/share/doc/qemu-kvm/system/arm/realview.html
/usr/share/doc/qemu-kvm/system/arm/stellaris.html
/usr/share/doc/qemu-kvm/system/arm/sx1.html
/usr/share/doc/qemu-kvm/system/arm/versatile.html
/usr/share/doc/qemu-kvm/system/arm/vexpress.html
/usr/share/doc/qemu-kvm/system/arm/virt.html
/usr/share/doc/qemu-kvm/system/arm/xscale.html
/usr/share/doc/qemu-kvm/system/build-platforms.html
/usr/share/doc/qemu-kvm/system/deprecated.html
/usr/share/doc/qemu-kvm/system/gdb.html
/usr/share/doc/qemu-kvm/system/genindex.html
/usr/share/doc/qemu-kvm/system/images.html
/usr/share/doc/qemu-kvm/system/index.html
/usr/share/doc/qemu-kvm/system/invocation.html
/usr/share/doc/qemu-kvm/system/ivshmem.html
/usr/share/doc/qemu-kvm/system/keys.html
/usr/share/doc/qemu-kvm/system/license.html
/usr/share/doc/qemu-kvm/system/linuxboot.html
/usr/share/doc/qemu-kvm/system/managed-startup.html
/usr/share/doc/qemu-kvm/system/monitor.html
/usr/share/doc/qemu-kvm/system/mux-chardev.html
/usr/share/doc/qemu-kvm/system/net.html
/usr/share/doc/qemu-kvm/system/qemu-block-drivers.html
/usr/share/doc/qemu-kvm/system/qemu-cpu-models.html
/usr/share/doc/qemu-kvm/system/qemu-manpage.html
/usr/share/doc/qemu-kvm/system/quickstart.html
/usr/share/doc/qemu-kvm/system/s390x/3270.html
/usr/share/doc/qemu-kvm/system/s390x/css.html
/usr/share/doc/qemu-kvm/system/s390x/protvirt.html
/usr/share/doc/qemu-kvm/system/s390x/vfio-ap.html
/usr/share/doc/qemu-kvm/system/s390x/vfio-ccw.html
/usr/share/doc/qemu-kvm/system/search.html
/usr/share/doc/qemu-kvm/system/security.html
/usr/share/doc/qemu-kvm/system/target-arm.html
/usr/share/doc/qemu-kvm/system/target-avr.html
/usr/share/doc/qemu-kvm/system/target-i386.html
/usr/share/doc/qemu-kvm/system/target-m68k.html
/usr/share/doc/qemu-kvm/system/target-mips.html
/usr/share/doc/qemu-kvm/system/target-ppc.html
/usr/share/doc/qemu-kvm/system/target-rx.html
/usr/share/doc/qemu-kvm/system/target-s390x.html
/usr/share/doc/qemu-kvm/system/target-sparc.html
/usr/share/doc/qemu-kvm/system/target-sparc64.html
/usr/share/doc/qemu-kvm/system/target-xtensa.html
/usr/share/doc/qemu-kvm/system/targets.html
/usr/share/doc/qemu-kvm/system/tls.html
/usr/share/doc/qemu-kvm/system/usb.html
/usr/share/doc/qemu-kvm/system/vnc-security.html
/usr/share/doc/qemu-kvm/tools/genindex.html
/usr/share/doc/qemu-kvm/tools/index.html
/usr/share/doc/qemu-kvm/tools/qemu-img.html
/usr/share/doc/qemu-kvm/tools/qemu-nbd.html
/usr/share/doc/qemu-kvm/tools/qemu-trace-stap.html
/usr/share/doc/qemu-kvm/tools/search.html
/usr/share/doc/qemu-kvm/tools/virtfs-proxy-helper.html
/usr/share/doc/qemu-kvm/tools/virtiofsd.html
/usr/share/doc/qemu-kvm/user/genindex.html
/usr/share/doc/qemu-kvm/user/index.html
/usr/share/doc/qemu-kvm/user/main.html
/usr/share/doc/qemu-kvm/user/search.html

2. new sub-package size(~6M)
# dnf info qemu-kvm-docs-5.1.0-17.module+el8.3.1+9213+7ace09c3.x86_64 | grep -iE '^size'
Size         : 5.8 M

3. this documentation html and txt have been removed from the common package and introduced into a new sub-package(qemu-kvm-docs)

# rpm -ql qemu-kvm-common-5.1.0-17.module+el8.3.1+9213+7ace09c3.x86_64 |grep txt
NULL
# rpm -ql qemu-kvm-common-5.1.0-17.module+el8.3.1+9213+7ace09c3.x86_64 |grep html
NULL

Base on this test result. move the bug to VERIFIED.  If missed anything, please let QE know.

Comment 12 errata-xmlrpc 2021-02-22 15:39:38 UTC
Since the problem described in this bug report should be
resolved in a recent advisory, it has been closed with a
resolution of ERRATA.

For information on the advisory (virt:8.3 bug fix and enhancement update), and where to find the updated
files, follow the link below.

If the solution does not work for you, open a new bug report.

https://access.redhat.com/errata/RHBA-2021:0639