Peter Maydell a69a6d4b4d scripts/qapi/parser.py: improve doc comment indent handling ... Make the handling of indentation in doc comments more sophisticated, so that when we see a section like: Notes: some text some more text indented line 3 we save it for the doc-comment processing code as: some text some more text indented line 3 and when we see a section with the heading on its own line: Notes: some text some more text indented text we also accept that and save it in the same form. If we detect that the comment document text is not indented as much as we expect it to be, we throw a parse error. (We don't complain about over-indented sections, because for rST this can be legitimate markup.) The golden reference for the doc comment text is updated to remove the two 'wrong' indents; these now form a test case that we correctly stripped leading whitespace from an indented multi-line argument definition. We update the documentation in docs/devel/qapi-code-gen.txt to describe the new indentation rules. Signed-off-by: Peter Maydell <peter.maydell@linaro.org> Message-Id: <20200925162316.21205-6-peter.maydell@linaro.org> Reviewed-by: Markus Armbruster <armbru@redhat.com> [Whitespace between sentences tweaked] 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
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/parser.py: improve doc comment indent handling	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
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
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
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
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
test-crypto-tlssession.c
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
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-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
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