[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[Qemu-devel] [PATCH v2 3/8] decodetree: Document the usefulness of argum
From: |
Richard Henderson |
Subject: |
[Qemu-devel] [PATCH v2 3/8] decodetree: Document the usefulness of argument sets |
Date: |
Wed, 27 Feb 2019 21:24:27 -0800 |
Cc: 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 v2 0/8] decodetree enhancements, Richard Henderson, 2019/02/28
- [Qemu-devel] [PATCH v2 1/8] MAINTAINERS: Add scripts/decodetree.py to the TCG section, Richard Henderson, 2019/02/28
- [Qemu-devel] [PATCH v2 7/8] test/decode: Add tests for PatternGroups, Richard Henderson, 2019/02/28
- [Qemu-devel] [PATCH v2 3/8] decodetree: Document the usefulness of argument sets,
Richard Henderson <=
- [Qemu-devel] [PATCH v2 6/8] decodetree: Allow grouping of overlapping patterns, Richard Henderson, 2019/02/28
- [Qemu-devel] [PATCH v2 5/8] decodetree: Do not unconditionaly return from Pattern.output_code, Richard Henderson, 2019/02/28
- [Qemu-devel] [PATCH v2 4/8] decodetree: Ensure build_tree does not include values outside insnmask, Richard Henderson, 2019/02/28
- [Qemu-devel] [PATCH v2 2/8] decodetree: Move documentation to docs/devel/decodetree.rst, Richard Henderson, 2019/02/28
- [Qemu-devel] [PATCH v2 8/8] decodetree: Add --static-decode option, Richard Henderson, 2019/02/28
- [Qemu-devel] [PATCH 9/8] decodetree: Produce clean output for an empty input file, Richard Henderson, 2019/02/28