Control: severity -1 wishlist Control: retitle -1 docs are not easy to find
12.06.2014 12:48, Michal Suchanek wrote:
Package: qemu-system-x86 Version: 2.0.0+dfsg-6 Severity: normal Hello, qemu git includes docs/usb2.txt which the debian packages d not seem to package.
Actually _all_ available documentation is shipped. The problem is that it is shipped in the "main" metapackage named "qemu", which also pulls _whole_ qemu. And these docs can be found in /usr/share/qemu. The problem is that I don't really know what to do with the docs. These docs are not a property of qemu-system-x86 package, because other qemu-system-* packages equally needs them, and shipping them in every subpackage is wrong. I can move at least qemu-system-specific docs to qemu-system-common, but this way, it will be difficult to find, because the docs will be in /usr/doc/qemu-system-common/ while you maybe be more expecting to find them in /usr/doc/qemu-system-x86/ - the package you're working with. Other docs are qemu-user-specific, but we have 2 of them - qemu-user and qemu-user-static, and again, adding docs to both is wrong, and there's no "common" package for qemu-user. On another side, in upstrem docs/ directory (in the source) there's no clear separation of what's system docs, what's user docs and what is other stuff (like programming docs or just overview). So any attempt to split them up is, well, at least difficult. Especially having in mind the docs are being shipped in the qemu metapackage currently (and that's the case since the beginning), so we'll have to "stole" these files from qemu package. That to say - I understand full well that current situation with documentation in qemu packaging is very bad. But I don't really know how to improve it. Suggestions welcome :) Thanks, /mjt -- To UNSUBSCRIBE, email to debian-bugs-dist-requ...@lists.debian.org with a subject of "unsubscribe". Trouble? Contact listmas...@lists.debian.org
