qemu/docs/system
Greg Kurz 22062e54bb ppc: Officially deprecate the CPU "compat" property
Server class POWER CPUs have a "compat" property, which was obsoleted
by commit 7843c0d60d and replaced by a "max-cpu-compat" property on the
pseries machine type. A hack was introduced so that passing "compat" to
-cpu would still produce the desired effect, for the sake of backward
compatibility : it strips the "compat" option from the CPU properties
and applies internally it to the pseries machine. The accessors of the
"compat" property were updated to do nothing but warn the user about the
deprecated status when doing something like:

$ qemu-system-ppc64 -global POWER9-family-powerpc64-cpu.compat=power9
qemu-system-ppc64: warning: CPU 'compat' property is deprecated and has no
 effect; use max-cpu-compat machine property instead

This was merged during the QEMU 2.10 timeframe, a few weeks before we
formalized our deprecation process. As a consequence, the "compat"
property fell through the cracks and was never listed in the officialy
deprecated features.

We are now eight QEMU versions later, it is largely time to mention it
in qemu-deprecated.texi. Also, since -global XXX-powerpc64-cpu.compat=
has been emitting warnings since QEMU 2.10 and the usual way of setting
CPU properties is with -cpu, completely remove the "compat" property.
Keep the hack so that -cpu XXX,compat= stays functional some more time,
as required by our deprecation process.

The now empty powerpc_servercpu_properties[] list which was introduced
for "compat" and never had any other use is removed on the way. We can
re-add it in the future if the need for a server class POWER CPU specific
property arises again.

Signed-off-by: Greg Kurz <groug@kaod.org>
Message-Id: <158274357799.140275.12263135811731647490.stgit@bahia.lan>
[dwg: Convert from .texi to .rst to match upstream change]
Signed-off-by: David Gibson <david@gibson.dropbear.id.au>
2020-03-17 09:41:14 +11:00
..
arm docs: add Orange Pi PC document 2020-03-12 16:27:33 +00:00
build-platforms.rst docs/system: convert Texinfo documentation to rST 2020-03-06 10:05:12 +00:00
conf.py docs: Generate qemu.1 manpage with Sphinx 2020-03-06 11:06:55 +00:00
cpu-models-mips.rst.inc docs/system: Convert qemu-cpu-models.texi to rST 2020-03-06 10:05:12 +00:00
cpu-models-x86.rst.inc docs/system: Convert qemu-cpu-models.texi to rST 2020-03-06 10:05:12 +00:00
deprecated.rst ppc: Officially deprecate the CPU "compat" property 2020-03-17 09:41:14 +11:00
device-url-syntax.rst.inc docs: Split out sections for the manpage into .rst.inc files 2020-03-06 11:06:55 +00:00
gdb.rst docs/system: convert Texinfo documentation to rST 2020-03-06 10:05:12 +00:00
images.rst docs/system: convert Texinfo documentation to rST 2020-03-06 10:05:12 +00:00
index.rst docs/system: convert Texinfo documentation to rST 2020-03-06 10:05:12 +00:00
invocation.rst docs: Split out sections for the manpage into .rst.inc files 2020-03-06 11:06:55 +00:00
ivshmem.rst docs/system: convert Texinfo documentation to rST 2020-03-06 10:05:12 +00:00
keys.rst docs: Split out sections for the manpage into .rst.inc files 2020-03-06 11:06:55 +00:00
keys.rst.inc docs: Split out sections for the manpage into .rst.inc files 2020-03-06 11:06:55 +00:00
license.rst docs/system: convert Texinfo documentation to rST 2020-03-06 10:05:12 +00:00
linuxboot.rst docs/system: convert Texinfo documentation to rST 2020-03-06 10:05:12 +00:00
managed-startup.rst docs/system: convert managed startup to rST. 2020-03-06 10:05:12 +00:00
monitor.rst hmp-commands-info.hx: Add rST documentation fragments 2020-03-06 10:05:12 +00:00
mux-chardev.rst docs: Split out sections for the manpage into .rst.inc files 2020-03-06 11:06:55 +00:00
mux-chardev.rst.inc docs: Split out sections for the manpage into .rst.inc files 2020-03-06 11:06:55 +00:00
net.rst docs/system: convert Texinfo documentation to rST 2020-03-06 10:05:12 +00:00
qemu-block-drivers.rst docs: Create defs.rst.inc as a place to define substitutions 2020-03-06 10:04:58 +00:00
qemu-block-drivers.rst.inc docs/system: put qemu-block-drivers body in an included file 2020-03-06 10:04:58 +00:00
qemu-cpu-models.rst docs/system: Convert qemu-cpu-models.texi to rST 2020-03-06 10:05:12 +00:00
qemu-manpage.rst docs: Generate qemu.1 manpage with Sphinx 2020-03-06 11:06:55 +00:00
quickstart.rst docs/system: convert Texinfo documentation to rST 2020-03-06 10:05:12 +00:00
security.rst docs/system: Convert security.texi to rST format 2020-03-06 10:05:12 +00:00
target-arm.rst docs: add Orange Pi PC document 2020-03-12 16:27:33 +00:00
target-i386-desc.rst.inc docs: Split out sections for the manpage into .rst.inc files 2020-03-06 11:06:55 +00:00
target-i386.rst docs: Split out sections for the manpage into .rst.inc files 2020-03-06 11:06:55 +00:00
target-m68k.rst docs: Roll semihosting option information into qemu-options.hx 2020-03-06 10:05:12 +00:00
target-mips.rst docs/system: convert Texinfo documentation to rST 2020-03-06 10:05:12 +00:00
target-ppc.rst docs: Roll -prom-env and -g target-specific info into qemu-options.hx 2020-03-06 10:05:18 +00:00
target-sparc64.rst docs: Roll -prom-env and -g target-specific info into qemu-options.hx 2020-03-06 10:05:18 +00:00
target-sparc.rst docs: Roll -prom-env and -g target-specific info into qemu-options.hx 2020-03-06 10:05:18 +00:00
target-xtensa.rst docs: Roll semihosting option information into qemu-options.hx 2020-03-06 10:05:12 +00:00
targets.rst docs/system: convert Texinfo documentation to rST 2020-03-06 10:05:12 +00:00
tls.rst docs/system: convert Texinfo documentation to rST 2020-03-06 10:05:12 +00:00
usb.rst docs/system: convert Texinfo documentation to rST 2020-03-06 10:05:12 +00:00
vfio-ap.rst docs: rstfy vfio-ap documentation 2020-02-26 18:57:07 +01:00
vnc-security.rst docs/system: convert Texinfo documentation to rST 2020-03-06 10:05:12 +00:00