Proxmox-Port/qemu
1
0
Fork 0
mirror of https://github.com/qemu/qemu.git synced 2025-08-07 14:43:53 +00:00
Code Issues Actions Packages Projects Releases Wiki Activity

docs/devel: Document decodetree no-overlap groups

Browse Source 
When support for this feature went in, the update to the
documentation was forgotten.

Fixes: 067e8b0f45
Reported-by: Peter Maydell <peter.maydell@linaro.org>
Signed-off-by: Richard Henderson <richard.henderson@linaro.org>
Reviewed-by: Peter Maydell <peter.maydell@linaro.org>
Message-id: 20200803205708.315829-1-richard.henderson@linaro.org
Signed-off-by: Peter Maydell <peter.maydell@linaro.org>
This commit is contained in:
Richard Henderson 2020-08-03 13:57:08 -07:00 committed by Peter Maydell
parent d15532d91b
commit ffdfca6fac
1 changed files with 18 additions and 11 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

29
docs/devel/decodetree.rst
View File

@ -173,18 +173,25 @@ Pattern Groups
Syntax:: Syntax::
group := '{' ( pat_def | group )+ '}' group := overlap_group | no_overlap_group
overlap_group := '{' ( pat_def | group )+ '}'
no_overlap_group := '[' ( pat_def | group )+ ']'
A *group* begins with a lone open-brace, with all subsequent lines A *group* begins with a lone open-brace or open-bracket, with all
indented two spaces, and ending with a lone close-brace. Groups subsequent lines indented two spaces, and ending with a lone
may be nested, increasing the required indentation of the lines close-brace or close-bracket. Groups may be nested, increasing the
within the nested group to two spaces per nesting level. required indentation of the lines within the nested group to two
spaces per nesting level.
Unlike ungrouped patterns, grouped patterns are allowed to overlap. Patterns within overlap groups are allowed to overlap. Conflicts are
Conflicts are resolved by selecting the patterns in order. If all resolved by selecting the patterns in order. If all of the fixedbits
of the fixedbits for a pattern match, its translate function will for a pattern match, its translate function will be called. If the
be called. If the translate function returns false, then subsequent translate function returns false, then subsequent patterns within the
patterns within the group will be matched. group will be matched.
Patterns within no-overlap groups are not allowed to overlap, just
the same as ungrouped patterns. Thus no-overlap groups are intended
to be nested inside overlap groups.
The following example from PA-RISC shows specialization of the *or* The following example from PA-RISC shows specialization of the *or*
instruction:: instruction::
@ -200,7 +207,7 @@ instruction::
When the *cf* field is zero, the instruction has no side effects, When the *cf* field is zero, the instruction has no side effects,
and may be specialized. When the *rt* field is zero, the output and may be specialized. When the *rt* field is zero, the output
is discarded and so the instruction has no effect. When the *rt2* is discarded and so the instruction has no effect. When the *rt2*
field is zero, the operation is ``reg[rt] | 0`` and so encodes field is zero, the operation is ``reg[r1] | 0`` and so encodes
the canonical register copy operation. the canonical register copy operation.
The output from the generator might look like:: The output from the generator might look like::