[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[Qemu-devel] [PATCH v3 03/12] decodetree: Document the usefulness of arg
From: |
Richard Henderson |
Subject: |
[Qemu-devel] [PATCH v3 03/12] decodetree: Document the usefulness of argument sets |
Date: |
Thu, 7 Mar 2019 10:56:13 -0800 |
Reviewed-by: Bastian Koppelmann <address@hidden>
Signed-off-by: Richard Henderson <address@hidden>
---
docs/devel/decodetree.rst | 7 +++++++
1 file changed, 7 insertions(+)
diff --git a/docs/devel/decodetree.rst b/docs/devel/decodetree.rst
index d9be30b2db..62cb7f687c 100644
--- a/docs/devel/decodetree.rst
+++ b/docs/devel/decodetree.rst
@@ -69,6 +69,13 @@ with each of the fields being one of the member arguments.
If ``!extern`` is specified, the backing structure is assumed
to have been already declared, typically via a second decoder.
+Argument sets are useful when one wants to define helper functions
+for the translator functions that can perform operations on a common
+set of arguments. This can ensure, for instance, that the ``AND``
+pattern and the ``OR`` pattern put their operands into the same named
+structure, so that a common ``gen_logic_insn`` may be able to handle
+the operations common between the two.
+
Argument set examples::
®3 ra rb rc
--
2.17.2
- [Qemu-devel] [PATCH v3 00/12] decodetree enhacements, Richard Henderson, 2019/03/07
- [Qemu-devel] [PATCH v3 01/12] MAINTAINERS: Add scripts/decodetree.py to the TCG section, Richard Henderson, 2019/03/07
- [Qemu-devel] [PATCH v3 02/12] decodetree: Move documentation to docs/devel/decodetree.rst, Richard Henderson, 2019/03/07
- [Qemu-devel] [PATCH v3 03/12] decodetree: Document the usefulness of argument sets,
Richard Henderson <=
- [Qemu-devel] [PATCH v3 04/12] decodetree: Ensure build_tree does not include values outside insnmask, Richard Henderson, 2019/03/07
- [Qemu-devel] [PATCH v3 05/12] decodetree: Do not unconditionaly return from Pattern.output_code, Richard Henderson, 2019/03/07
- [Qemu-devel] [PATCH v3 07/12] test/decode: Add tests for PatternGroups, Richard Henderson, 2019/03/07
- [Qemu-devel] [PATCH v3 06/12] decodetree: Allow grouping of overlapping patterns, Richard Henderson, 2019/03/07
- [Qemu-devel] [PATCH v3 08/12] decodetree: Add --static-decode option, Richard Henderson, 2019/03/07
- [Qemu-devel] [PATCH v3 09/12] decodetree: Produce clean output for an empty input file, Richard Henderson, 2019/03/07
- [Qemu-devel] [PATCH v3 11/12] decodetree: Prefix extract function names with decode_function, Richard Henderson, 2019/03/07
- [Qemu-devel] [PATCH v3 10/12] decodetree: Allow +- to begin a number initializing a field, Richard Henderson, 2019/03/07
- [Qemu-devel] [PATCH v3 12/12] decodetree: Properly diagnose fields overflowing an insn, Richard Henderson, 2019/03/07