Skip to content

Commit

Permalink
Make metavariables used in execution spec more consistent
Browse files Browse the repository at this point in the history
Many of the new GC instructions used metavariables like `\typeidx` and
`\dataidx` in their prose, but `x` and `y` in their formalisms. To make the
prose and formalisms more consistent, and for consistency with the metavariables
used for other pre-existing instructions, use the `x` and `y` metavariables
everywhere.
  • Loading branch information
tlively committed Jul 19, 2023
1 parent 76e0d6b commit 8564ff3
Showing 1 changed file with 62 additions and 62 deletions.
124 changes: 62 additions & 62 deletions document/core/exec/instructions.rst
Original file line number Diff line number Diff line change
Expand Up @@ -424,14 +424,14 @@ Reference Instructions
.. _exec-struct.new:

:math:`\STRUCTNEW~\typeidx`
...........................
:math:`\STRUCTNEW~x`
....................

.. todo:: unroll type

1. Assert: due to :ref:`validation <valid-struct.new>`, the :ref:`defined type <syntax-deftype>` :math:`F.\AMODULE.\MITYPES[\typeidx]` exists.
1. Assert: due to :ref:`validation <valid-struct.new>`, the :ref:`defined type <syntax-deftype>` :math:`F.\AMODULE.\MITYPES[x]` exists.

2. Let :math:`\deftype` be the :ref:`defined type <syntax-deftype>` :math:`F.\AMODULE.\MITYPES[\typeidx]`.
2. Let :math:`\deftype` be the :ref:`defined type <syntax-deftype>` :math:`F.\AMODULE.\MITYPES[x]`.

3. Assert: due to :ref:`validation <valid-struct.new>`, :math:`\deftype` is a :ref:`structure type <syntax-structtype>`.

Expand Down Expand Up @@ -471,14 +471,14 @@ Reference Instructions
.. _exec-struct.new_default:

:math:`\STRUCTNEWDEFAULT~\typeidx`
..................................
:math:`\STRUCTNEWDEFAULT~x`
...........................

.. todo:: unroll type

1. Assert: due to :ref:`validation <valid-struct.new_default>`, the :ref:`defined type <syntax-deftype>` :math:`F.\AMODULE.\MITYPES[\typeidx]` exists.
1. Assert: due to :ref:`validation <valid-struct.new_default>`, the :ref:`defined type <syntax-deftype>` :math:`F.\AMODULE.\MITYPES[x]` exists.

2. Let :math:`\deftype` be the :ref:`defined type <syntax-deftype>` :math:`F.\AMODULE.\MITYPES[\typeidx]`.
2. Let :math:`\deftype` be the :ref:`defined type <syntax-deftype>` :math:`F.\AMODULE.\MITYPES[x]`.

3. Assert: due to :ref:`validation <valid-struct.new_default>`, :math:`\deftype` is a :ref:`structure type <syntax-structtype>`.

Expand All @@ -494,7 +494,7 @@ Reference Instructions

c. Push the :ref:`value <syntax-val>` :math:`\default_{t_i}` to the stack.

7. Execute the instruction :math:`(\STRUCTNEW~\typeidx)`.
7. Execute the instruction :math:`(\STRUCTNEW~x)`.

.. math::
\begin{array}{lcl@{\qquad}l}
Expand All @@ -521,14 +521,14 @@ Reference Instructions
.. _exec-struct.get:
.. _exec-struct.get_sx:

:math:`\STRUCTGET\K{\_}\sx^?~\typeidx~i`
........................................
:math:`\STRUCTGET\K{\_}\sx^?~x~i`
.................................

.. todo:: unroll type

1. Assert: due to :ref:`validation <valid-struct.get>`, the :ref:`defined type <syntax-deftype>` :math:`F.\AMODULE.\MITYPES[\typeidx]` exists.
1. Assert: due to :ref:`validation <valid-struct.get>`, the :ref:`defined type <syntax-deftype>` :math:`F.\AMODULE.\MITYPES[x]` exists.

2. Let :math:`\deftype` be the :ref:`defined type <syntax-deftype>` :math:`F.\AMODULE.\MITYPES[\typeidx]`.
2. Let :math:`\deftype` be the :ref:`defined type <syntax-deftype>` :math:`F.\AMODULE.\MITYPES[x]`.

3. Assert: due to :ref:`validation <valid-struct.get>`, :math:`\deftype` is a :ref:`structure type <syntax-structtype>` with at least :math:`i + 1` fields.

Expand Down Expand Up @@ -570,14 +570,14 @@ Reference Instructions
.. _exec-struct.set:

:math:`\STRUCTSET~\typeidx~i`
.............................
:math:`\STRUCTSET~x~i`
......................

.. todo:: unroll type

1. Assert: due to :ref:`validation <valid-struct.set>`, the :ref:`defined type <syntax-deftype>` :math:`F.\AMODULE.\MITYPES[\typeidx]` exists.
1. Assert: due to :ref:`validation <valid-struct.set>`, the :ref:`defined type <syntax-deftype>` :math:`F.\AMODULE.\MITYPES[x]` exists.

2. Let :math:`\deftype` be the :ref:`defined type <syntax-deftype>` :math:`F.\AMODULE.\MITYPES[\typeidx]`.
2. Let :math:`\deftype` be the :ref:`defined type <syntax-deftype>` :math:`F.\AMODULE.\MITYPES[x]`.

3. Assert: due to :ref:`validation <valid-struct.set>`, :math:`\deftype` is a :ref:`structure type <syntax-structtype>` with at least :math:`i + 1` fields.

Expand Down Expand Up @@ -621,14 +621,14 @@ Reference Instructions
.. _exec-array.new:

:math:`\ARRAYNEW~\typeidx`
..........................
:math:`\ARRAYNEW~x`
...................

.. todo:: unroll type

1. Assert: due to :ref:`validation <valid-array.new>`, the :ref:`defined type <syntax-deftype>` :math:`F.\AMODULE.\MITYPES[\typeidx]` exists.
1. Assert: due to :ref:`validation <valid-array.new>`, the :ref:`defined type <syntax-deftype>` :math:`F.\AMODULE.\MITYPES[x]` exists.

2. Let :math:`\deftype` be the :ref:`defined type <syntax-deftype>` :math:`F.\AMODULE.\MITYPES[\typeidx]`.
2. Let :math:`\deftype` be the :ref:`defined type <syntax-deftype>` :math:`F.\AMODULE.\MITYPES[x]`.

3. Assert: due to :ref:`validation <valid-array.new>`, :math:`\deftype` is an :ref:`array type <syntax-arraytype>`.

Expand All @@ -644,7 +644,7 @@ Reference Instructions

9. Push the value :math:`\val` to the stack :math:`n` times.

10. Execute the instruction :math:`(\ARRAYNEWFIXED~\typeidx~n)`.
10. Execute the instruction :math:`(\ARRAYNEWFIXED~x~n)`.

.. math::
\begin{array}{lcl@{\qquad}l}
Expand All @@ -666,14 +666,14 @@ Reference Instructions
.. _exec-array.new_default:

:math:`\ARRAYNEWDEFAULT~\typeidx`
..................................
:math:`\ARRAYNEWDEFAULT~x`
..........................

.. todo:: unroll type

1. Assert: due to :ref:`validation <valid-array.new_default>`, the :ref:`defined type <syntax-deftype>` :math:`F.\AMODULE.\MITYPES[\typeidx]` exists.
1. Assert: due to :ref:`validation <valid-array.new_default>`, the :ref:`defined type <syntax-deftype>` :math:`F.\AMODULE.\MITYPES[x]` exists.

2. Let :math:`\deftype` be the :ref:`defined type <syntax-deftype>` :math:`F.\AMODULE.\MITYPES[\typeidx]`.
2. Let :math:`\deftype` be the :ref:`defined type <syntax-deftype>` :math:`F.\AMODULE.\MITYPES[x]`.

3. Assert: due to :ref:`validation <valid-array.new_default>`, :math:`\deftype` is an :ref:`array type <syntax-arraytype>`.

Expand All @@ -689,7 +689,7 @@ Reference Instructions

9. Push the :ref:`value <syntax-val>` :math:`\default_t` to the stack :math:`n` times.

10. Execute the instruction :math:`(\ARRAYNEWFIXED~\typeidx~n)`.
10. Execute the instruction :math:`(\ARRAYNEWFIXED~x~n)`.

.. math::
\begin{array}{lcl@{\qquad}l}
Expand All @@ -715,14 +715,14 @@ Reference Instructions
.. _exec-array.new_fixed:

:math:`\ARRAYNEWFIXED~\typeidx~n`
.................................
:math:`\ARRAYNEWFIXED~x~n`
..........................

.. todo:: unroll type

1. Assert: due to :ref:`validation <valid-array.new_fixed>`, the :ref:`defined type <syntax-deftype>` :math:`F.\AMODULE.\MITYPES[\typeidx]` exists.
1. Assert: due to :ref:`validation <valid-array.new_fixed>`, the :ref:`defined type <syntax-deftype>` :math:`F.\AMODULE.\MITYPES[x]` exists.

2. Let :math:`\deftype` be the :ref:`defined type <syntax-deftype>` :math:`F.\AMODULE.\MITYPES[\typeidx]`.
2. Let :math:`\deftype` be the :ref:`defined type <syntax-deftype>` :math:`F.\AMODULE.\MITYPES[x]`.

3. Assert: due to :ref:`validation <valid-array.new_fixed>`, :math:`\deftype` is a :ref:`array type <syntax-arraytype>`.

Expand Down Expand Up @@ -760,23 +760,23 @@ Reference Instructions
.. _exec-array.new_data:

:math:`\ARRAYNEWDATA~\typeidx~\dataidx`
.......................................
:math:`\ARRAYNEWDATA~x~y`
.........................

.. todo:: extend type size convention to field types
.. todo:: unroll type

1. Assert: due to :ref:`validation <valid-array.new_data>`, the :ref:`defined type <syntax-deftype>` :math:`F.\AMODULE.\MITYPES[\typeidx]` exists.
1. Assert: due to :ref:`validation <valid-array.new_data>`, the :ref:`defined type <syntax-deftype>` :math:`F.\AMODULE.\MITYPES[x]` exists.

2. Let :math:`\deftype` be the :ref:`defined type <syntax-deftype>` :math:`F.\AMODULE.\MITYPES[\typeidx]`.
2. Let :math:`\deftype` be the :ref:`defined type <syntax-deftype>` :math:`F.\AMODULE.\MITYPES[x]`.

3. Assert: due to :ref:`validation <valid-array.new_data>`, :math:`\deftype` is an :ref:`array type <syntax-arraytype>`.

4. Let :math:`\TARRAY~\X{ft}` be the :ref:`array type <syntax-arraytype>` :math:`\deftype`. (todo: unroll)

5. Assert: due to :ref:`validation <valid-array.new_data>`, the :ref:`data address <syntax-dataaddr>` :math:`F.\AMODULE.\MIDATAS[\dataidx]` exists.
5. Assert: due to :ref:`validation <valid-array.new_data>`, the :ref:`data address <syntax-dataaddr>` :math:`F.\AMODULE.\MIDATAS[y]` exists.

6. Let :math:`\X{da}` be the :ref:`data address <syntax-dataaddr>` :math:`F.\AMODULE.\MIDATAS[\dataidx]`.
6. Let :math:`\X{da}` be the :ref:`data address <syntax-dataaddr>` :math:`F.\AMODULE.\MIDATAS[y]`.

7. Assert: due to :ref:`validation <valid-array.new_data>`, the :ref:`data instance <syntax-datainst>` :math:`S.\SDATAS[\X{da}]` exists.

Expand Down Expand Up @@ -806,7 +806,7 @@ Reference Instructions

b. Push the value :math:`(t.\CONST~c_i)` to the stack.

18. Execute the instruction :math:`(\ARRAYNEWFIXED~\typeidx~n)`.
18. Execute the instruction :math:`(\ARRAYNEWFIXED~x~n)`.

.. math::
~\\[-1ex]
Expand All @@ -830,22 +830,22 @@ Reference Instructions
.. _exec-array.new_elem:

:math:`\ARRAYNEWELEM~\typeidx~\elemidx`
.......................................
:math:`\ARRAYNEWELEM~x~y`
.........................

.. todo:: unroll type

1. Assert: due to :ref:`validation <valid-array.new_elem>`, the :ref:`defined type <syntax-deftype>` :math:`F.\AMODULE.\MITYPES[\typeidx]` exists.
1. Assert: due to :ref:`validation <valid-array.new_elem>`, the :ref:`defined type <syntax-deftype>` :math:`F.\AMODULE.\MITYPES[x]` exists.

2. Let :math:`\deftype` be the :ref:`defined type <syntax-deftype>` :math:`F.\AMODULE.\MITYPES[\typeidx]`.
2. Let :math:`\deftype` be the :ref:`defined type <syntax-deftype>` :math:`F.\AMODULE.\MITYPES[\x]`.

3. Assert: due to :ref:`validation <valid-array.new_elem>`, :math:`\deftype` is an :ref:`array type <syntax-arraytype>`.

4. Let :math:`\TARRAY~\X{ft}` be the :ref:`array type <syntax-arraytype>` :math:`\deftype`. (todo: unroll)

5. Assert: due to :ref:`validation <valid-array.new_elem>`, the :ref:`element address <syntax-elemaddr>` :math:`F.\AMODULE.\MIELEMS[\elemidx]` exists.
5. Assert: due to :ref:`validation <valid-array.new_elem>`, the :ref:`element address <syntax-elemaddr>` :math:`F.\AMODULE.\MIELEMS[y]` exists.

6. Let :math:`\X{ea}` be the :ref:`element address <syntax-elemaddr>` :math:`F.\AMODULE.\MIELEMS[\elemidx]`.
6. Let :math:`\X{ea}` be the :ref:`element address <syntax-elemaddr>` :math:`F.\AMODULE.\MIELEMS[y]`.

7. Assert: due to :ref:`validation <valid-array.new_elem>`, the :ref:`element instance <syntax-eleminst>` :math:`S.\SELEMS[\X{ea}]` exists.

Expand All @@ -865,7 +865,7 @@ Reference Instructions

14. Push the references :math:`\reff^\ast` to the stack.

15. Execute the instruction :math:`(\ARRAYNEWFIXED~\typeidx~n)`.
15. Execute the instruction :math:`(\ARRAYNEWFIXED~x~n)`.

.. math::
~\\[-1ex]
Expand All @@ -885,14 +885,14 @@ Reference Instructions
.. _exec-array.get:
.. _exec-array.get_sx:

:math:`\ARRAYGET\K{\_}\sx^?~\typeidx`
.....................................
:math:`\ARRAYGET\K{\_}\sx^?~x`
..............................

.. todo:: unroll type

1. Assert: due to :ref:`validation <valid-array.get>`, the :ref:`defined type <syntax-deftype>` :math:`F.\AMODULE.\MITYPES[\typeidx]` exists.
1. Assert: due to :ref:`validation <valid-array.get>`, the :ref:`defined type <syntax-deftype>` :math:`F.\AMODULE.\MITYPES[x]` exists.

2. Let :math:`\deftype` be the :ref:`defined type <syntax-deftype>` :math:`F.\AMODULE.\MITYPES[\typeidx]`.
2. Let :math:`\deftype` be the :ref:`defined type <syntax-deftype>` :math:`F.\AMODULE.\MITYPES[x]`.

3. Assert: due to :ref:`validation <valid-array.get>`, :math:`\deftype` is an :ref:`array type <syntax-arraytype>`.

Expand Down Expand Up @@ -942,14 +942,14 @@ Reference Instructions
.. _exec-array.set:

:math:`\ARRAYSET~\typeidx`
..........................
:math:`\ARRAYSET~x`
...................

.. todo:: unroll type

1. Assert: due to :ref:`validation <valid-array.set>`, the :ref:`defined type <syntax-deftype>` :math:`F.\AMODULE.\MITYPES[\typeidx]` exists.
1. Assert: due to :ref:`validation <valid-array.set>`, the :ref:`defined type <syntax-deftype>` :math:`F.\AMODULE.\MITYPES[x]` exists.

2. Let :math:`\deftype` be the :ref:`defined type <syntax-deftype>` :math:`F.\AMODULE.\MITYPES[\typeidx]`.
2. Let :math:`\deftype` be the :ref:`defined type <syntax-deftype>` :math:`F.\AMODULE.\MITYPES[x]`.

3. Assert: due to :ref:`validation <valid-array.set>`, :math:`\deftype` is an :ref:`array type <syntax-arraytype>`.

Expand All @@ -959,7 +959,7 @@ Reference Instructions

6. Pop the value :math:`\val` from the stack.

7. Assert: due to :ref:`validation <valid-array.get>`, a :ref:`value <syntax-val>` of :ref:`type <syntax-valtype>` :math:`\I32` is on the top of the stack.
7. Assert: due to :ref:`validation <valid-array.set>`, a :ref:`value <syntax-val>` of :ref:`type <syntax-valtype>` :math:`\I32` is on the top of the stack.

8. Pop the value :math:`(\I32.\CONST~i)` from the stack.

Expand Down Expand Up @@ -1029,8 +1029,8 @@ Reference Instructions
.. _exec-array.fill:

:math:`\ARRAYFILL~\typeidx`
...........................
:math:`\ARRAYFILL~x`
....................

.. todo:: Prose

Expand Down Expand Up @@ -1063,8 +1063,8 @@ Reference Instructions
.. _exec-array.copy:

:math:`\ARRAYCOPY~\typeidx~\typeidx`
....................................
:math:`\ARRAYCOPY~x~y`
......................

.. todo:: Prose

Expand Down Expand Up @@ -1115,8 +1115,8 @@ Reference Instructions
.. _exec-array.init_data:

:math:`\ARRAYINITDATA~\typeidx~\dataidx`
........................................
:math:`\ARRAYINITDATA~x~y`
..........................

.. todo:: Prose

Expand Down Expand Up @@ -1156,8 +1156,8 @@ Reference Instructions
.. _exec-array.init_elem:

:math:`\ARRAYINITELEM~\typeidx~\elemidx`
........................................
:math:`\ARRAYINITELEM~x~y`
..........................

.. todo:: Prose

Expand Down

0 comments on commit 8564ff3

Please sign in to comment.