[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[Qemu-devel] [PULL 03/12] decodetree: Document the usefulness of argumen
From: |
Richard Henderson |
Subject: |
[Qemu-devel] [PULL 03/12] decodetree: Document the usefulness of argument sets |
Date: |
Tue, 12 Mar 2019 10:03:25 -0700 |
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] [PULL 00/12] decodetree patches, Richard Henderson, 2019/03/12
- [Qemu-devel] [PULL 11/12] decodetree: Prefix extract function names with decode_function, Richard Henderson, 2019/03/12
- [Qemu-devel] [PULL 10/12] decodetree: Allow +- to begin a number initializing a field, Richard Henderson, 2019/03/12
- [Qemu-devel] [PULL 12/12] decodetree: Properly diagnose fields overflowing an insn, Richard Henderson, 2019/03/12
- [Qemu-devel] [PULL 07/12] test/decode: Add tests for PatternGroups, Richard Henderson, 2019/03/12
- [Qemu-devel] [PULL 09/12] decodetree: Produce clean output for an empty input file, Richard Henderson, 2019/03/12
- [Qemu-devel] [PULL 08/12] decodetree: Add --static-decode option, Richard Henderson, 2019/03/12
- [Qemu-devel] [PULL 04/12] decodetree: Ensure build_tree does not include values outside insnmask, Richard Henderson, 2019/03/12
- [Qemu-devel] [PULL 05/12] decodetree: Do not unconditionaly return from Pattern.output_code, Richard Henderson, 2019/03/12
- [Qemu-devel] [PULL 06/12] decodetree: Allow grouping of overlapping patterns, Richard Henderson, 2019/03/12
- [Qemu-devel] [PULL 03/12] decodetree: Document the usefulness of argument sets,
Richard Henderson <=
- [Qemu-devel] [PULL 01/12] MAINTAINERS: Add scripts/decodetree.py to the TCG section, Richard Henderson, 2019/03/12
- [Qemu-devel] [PULL 02/12] decodetree: Move documentation to docs/devel/decodetree.rst, Richard Henderson, 2019/03/12
- Re: [Qemu-devel] [PULL 00/12] decodetree patches, Peter Maydell, 2019/03/13