Peter Maydell 99dff36d3a scripts/qapi: Move doc-comment whitespace stripping to doc.py ... As we accumulate lines from doc comments when parsing the JSON, the QAPIDoc class generally strips leading and trailing whitespace using line.strip() when it calls _append_freeform(). This is fine for Texinfo, but for rST leading whitespace is significant. We'd like to move to having the text in doc comments be rST format rather than a custom syntax, so move the removal of leading whitespace from the QAPIDoc class to the texinfo-specific processing code in texi_format() in qapi/doc.py. (Trailing whitespace will always be stripped by the rstrip() in Section::append regardless.) In a followup commit we will make the whitespace in the lines of doc comment sections more consistently follow the input source. There is no change to the generated .texi files before and after this commit. Because the qapi-schema test checks the exact values of the documentation comments against a reference, we need to update that reference to match the new whitespace. In the first four places this is now correctly checking that we did put in the amount of whitespace to pass a rST-formatted list to the backend; in the last two places the extra whitespace is 'wrong' and will go away again in the following commit. Reviewed-by: Richard Henderson <richard.henderson@linaro.org> Reviewed-by: Markus Armbruster <armbru@redhat.com> Signed-off-by: Peter Maydell <peter.maydell@linaro.org> Message-Id: <20200925162316.21205-5-peter.maydell@linaro.org> Signed-off-by: Markus Armbruster <armbru@redhat.com>		2020-09-29 17:55:39 +02:00
..
acceptance	tests/acceptance: Skip slow quanta-gsj U-boot+Linux test	2020-09-18 19:46:38 +02:00
data	tests/acpi: drop unnecessary files	2020-09-29 07:10:37 -04:00
decode	decodetree: Improve identifier matching	2020-09-14 14:23:19 +01:00
docker	docker.py: always use --rm	2020-09-18 10:44:47 +01:00
fp	meson: convert tests/fp and check-softfloat	2020-08-21 06:30:15 -04:00
guest-debug	tests/guest-debug: catch hanging guests	2020-05-15 15:25:07 +01:00
image-fuzzer	image-fuzzer: Use OSerror.strerror instead of tuple subscript	2019-11-05 16:36:11 +01:00
include	meson: build qapi tests library	2020-09-08 07:17:09 +02:00
keys
migration	meson: convert migration/initrd-stress	2020-09-08 11:43:16 +02:00
multiboot	meson: link emulators without Makefile.target	2020-08-21 06:30:40 -04:00
perf/block/qcow2
plugin	plugins: move the more involved plugins to contrib	2020-09-10 10:47:03 +01:00
qapi-schema	scripts/qapi: Move doc-comment whitespace stripping to doc.py	2020-09-29 17:55:39 +02:00
qemu-iotests	tests/acpi: drop unnecessary files	2020-09-29 07:10:37 -04:00
qtest	tests/acpi: drop unnecessary files	2020-09-29 07:10:37 -04:00
rocker
tcg	plugins: move the more involved plugins to contrib	2020-09-10 10:47:03 +01:00
tsan	tests/docker: Added docker build support for TSan.	2020-06-16 14:49:05 +01:00
uefi-test-tools	roms/efirom, tests/uefi-test-tools: update edk2's own submodules first	2020-09-13 23:03:14 +02:00
vm	meson: convert po/	2020-08-21 06:30:45 -04:00
vmstate-static-checker-data
.gitignore	tests/tcg/aarch64: add a gdbstub testcase for SVE registers	2020-03-17 17:38:47 +00:00
atomic64-bench.c	qemu/atomic.h: rename atomic_ to qatomic_	2020-09-23 16:07:44 +01:00
atomic_add-bench.c	qemu/atomic.h: rename atomic_ to qatomic_	2020-09-23 16:07:44 +01:00
benchmark-crypto-cipher.c	tests: fix output message formatting for crypto benchmarks	2020-09-10 11:02:17 +01:00
benchmark-crypto-hash.c	tests: fix output message formatting for crypto benchmarks	2020-09-10 11:02:17 +01:00
benchmark-crypto-hmac.c	tests: fix output message formatting for crypto benchmarks	2020-09-10 11:02:17 +01:00
check-block-qdict.c	tests: Use error_free_or_abort() where appropriate	2020-07-02 06:25:28 +02:00
check-block.sh	iotests: Skip test_stream_parallel in test 030 when doing "make check"	2020-09-15 11:05:13 +02:00
check-qdict.c
check-qjson.c
check-qlist.c	qobject: Eliminate qlist_iter(), use QLIST_FOREACH_ENTRY() instead	2020-04-30 06:51:15 +02:00
check-qlit.c
check-qnull.c
check-qnum.c
check-qobject.c	tests: Use &error_abort where appropriate	2020-07-02 06:25:28 +02:00
check-qom-interface.c	Use DECLARE_*CHECKER* macros	2020-09-09 09:27:09 -04:00
check-qom-proplist.c	qom: Clean up object_property_get_enum()'s error value	2020-09-18 13:49:48 -04:00
check-qstring.c
crypto-tls-psk-helpers.c
crypto-tls-psk-helpers.h
crypto-tls-x509-helpers.c	crypto: use a stronger private key for tests	2020-07-17 14:20:57 +02:00
crypto-tls-x509-helpers.h
dbus-vmstate-daemon.sh	tests: add dbus-vmstate-test	2020-01-06 18:41:32 +04:00
io-channel-helpers.c
io-channel-helpers.h
iothread.c	qemu/atomic.h: rename atomic_ to qatomic_	2020-09-23 16:07:44 +01:00
iothread.h
Makefile.include	plugins: move the more involved plugins to contrib	2020-09-10 10:47:03 +01:00
meson.build	tests: add test-fdmon-epoll	2020-09-23 13:45:52 +01:00
pkix_asn1_tab.c
ptimer-test-stubs.c
ptimer-test.c	tests/ptimer: Remove unnecessary inclusion of libqtest.h	2020-01-12 11:42:40 +01:00
ptimer-test.h
qht-bench.c	qemu/atomic.h: rename atomic_ to qatomic_	2020-09-23 16:07:44 +01:00
rcutorture.c	qemu/atomic.h: rename atomic_ to qatomic_	2020-09-23 16:07:44 +01:00
requirements.txt	tests: bump avocado version	2020-09-10 10:46:46 +01:00
socket-helpers.c	tests/socket-helpers: Treat EAI_NONAME as EADDRNOTAVAIL	2020-09-16 08:41:06 +02:00
socket-helpers.h
test-aio-multithread.c	qemu/atomic.h: rename atomic_ to qatomic_	2020-09-23 16:07:44 +01:00
test-aio.c	util/async: make bh_aio_poll() O(1)	2020-02-22 08:26:47 +00:00
test-authz-list.c
test-authz-listfile.c
test-authz-pam.c
test-authz-simple.c
test-base64.c	tests: Use error_free_or_abort() where appropriate	2020-07-02 06:25:28 +02:00
test-bdrv-drain.c	block: Drop @child_class from bdrv_child_perm()	2020-05-18 19:05:25 +02:00
test-bdrv-graph-mod.c	tests: Use error_free_or_abort() where appropriate	2020-07-02 06:25:28 +02:00
test-bitcnt.c
test-bitmap.c	tests: use g_test_rand_int	2019-12-17 09:05:23 +01:00
test-bitops.c
test-block-backend.c
test-block-iothread.c	tests: Use error_free_or_abort() where appropriate	2020-07-02 06:25:28 +02:00
test-blockjob-txn.c
test-blockjob.c	job: take each job's lock individually in job_txn_apply	2020-04-07 14:34:47 +02:00
test-bufferiszero.c
test-char.c	test-char: abort on serial test error	2020-07-28 18:27:59 +04:00
test-clone-visitor.c
test-coroutine.c
test-crypto-afsplit.c
test-crypto-block.c
test-crypto-cipher.c	tests: Use error_free_or_abort() where appropriate	2020-07-02 06:25:28 +02:00
test-crypto-hash.c
test-crypto-hmac.c
test-crypto-ivgen.c
test-crypto-pbkdf.c
test-crypto-secret.c	meson: declare keyutils dependency	2020-09-08 07:17:09 +02:00
test-crypto-tlscredsx509.c	glib: use portable g_setenv()	2019-12-17 09:05:23 +01:00
test-crypto-tlssession.c	glib: use portable g_setenv()	2019-12-17 09:05:23 +01:00
test-crypto-xts.c
test-cutils.c
test-fdmon-epoll.c	tests: add test-fdmon-epoll	2020-09-23 13:45:52 +01:00
test-hbitmap.c	block/dirty-bitmap: improve _next_dirty_area API	2020-03-18 14:03:46 -04:00
test-image-locking.c
test-int128.c
test-io-channel-buffer.c
test-io-channel-command.c
test-io-channel-file.c	tests: Fixes test-io-channel-file by mask only owner file state mask bits	2020-09-16 12:15:07 +02:00
test-io-channel-socket.c	tests: Fixes test-io-channel-socket.c tests under msys2/mingw	2020-09-16 08:41:06 +02:00
test-io-channel-tls.c	glib: use portable g_setenv()	2019-12-17 09:05:23 +01:00
test-io-task.c	tests: Use error_free_or_abort() where appropriate	2020-07-02 06:25:28 +02:00
test-iov.c	util/iov: add iov_discard_undo()	2020-09-23 13:41:58 +01:00
test-keyval.c	test-keyval: Tighten test of trailing crap after size	2019-12-18 12:28:44 +01:00
test-logging.c	qemu/atomic.h: rename atomic_ to qatomic_	2020-09-23 16:07:44 +01:00
test-mul64.c
test-opts-visitor.c
test-qapi-util.c
test-qdev-global-props.c	tests: Fixes test-qdev-global-props.c	2020-09-16 12:15:07 +02:00
test-qdist.c
test-qemu-opts.c	tests: Use &error_abort where appropriate	2020-07-02 06:25:28 +02:00
test-qga.c	meson: convert the unit tests	2020-09-08 11:43:16 +02:00
test-qgraph.c	meson: convert tests/qtest to meson	2020-08-21 06:30:20 -04:00
test-qht-par.c
test-qht.c
test-qmp-cmds.c	qapi: Add feature flags to remaining definitions	2020-03-17 19:58:34 +01:00
test-qmp-event.c	tests/test-qmp-event: Check event is actually emitted	2020-03-17 19:58:34 +01:00
test-qobject-input-visitor.c	qapi: enable use of g_autoptr with QAPI types	2020-09-03 09:38:36 +02:00
test-qobject-output-visitor.c	qapi: Assert output visitors see only valid enum values	2020-04-30 07:26:09 +02:00
test-rcu-list.c	qemu/atomic.h: rename atomic_ to qatomic_	2020-09-23 16:07:44 +01:00
test-rcu-simpleq.c
test-rcu-slist.c	rcu_queue: add QSLIST functions	2020-02-22 08:26:47 +00:00
test-rcu-tailq.c
test-replication.c	tests: test-replication disable /replication/secondary/* on msys2/mingw.	2020-09-16 08:41:06 +02:00
test-shift128.c
test-string-input-visitor.c	tests: Use &error_abort where appropriate	2020-07-02 06:25:28 +02:00
test-string-output-visitor.c	tests: Use &error_abort where appropriate	2020-07-02 06:25:28 +02:00
test-thread-pool.c	qemu/atomic.h: rename atomic_ to qatomic_	2020-09-23 16:07:44 +01:00
test-throttle.c
test-timed-average.c
test-util-filemonitor.c	tests: Fixes building test-util-filemonitor.c on msys2/mingw	2020-09-07 12:34:17 +02:00
test-util-sockets.c	tests: fix test-util-sockets.c	2020-09-16 12:15:07 +02:00
test-uuid.c
test-visitor-serialization.c
test-vmstate.c	vmstate: Fixes test-vmstate.c on msys2/mingw	2020-09-16 08:41:06 +02:00
test-write-threshold.c
test-x86-cpuid.c	Revert "hw/i386: Update structures to save the number of nodes per package"	2020-09-02 07:29:26 -04:00
test-xbzrle.c
vhost-user-bridge.c