From cc5ee13bfd1ad4b3e689747c83d5b5b6645b427f Mon Sep 17 00:00:00 2001 From: eleses Date: Wed, 6 Aug 2025 19:23:15 +0300 Subject: [PATCH 1/3] subsinstr p(X), passign & pcount gotchas --- docs/opcodes/subinstr.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/docs/opcodes/subinstr.md b/docs/opcodes/subinstr.md index 4e2920900be..82a8e273af5 100644 --- a/docs/opcodes/subinstr.md +++ b/docs/opcodes/subinstr.md @@ -32,6 +32,10 @@ _p4, p5, ..._ -- Additional input values the are mapped to the called instrument The called instrument's p2 and p3 values will be identical to the host instrument's values. While the host instrument can [control its own duration](../control/durctl.md), any such attempts inside the called instrument will most likely have no effect. +> :memo: **Note** +> +> Only the `p4` style accessors can read the actual parameter values passed to subinstruments. In a subinstrument, `p(4)` returns the host's `p4`, and so does `passign`. Furthermre, `pcount` returns the host's parameter count, not the subinsturment's. + ## Examples === "Modern" From e268fa13250c9fe5fa5020835de99ec77b576125 Mon Sep 17 00:00:00 2001 From: eleses Date: Wed, 6 Aug 2025 19:46:52 +0300 Subject: [PATCH 2/3] clarifty wording by adding "unparanthesized" and "in contrast". --- docs/opcodes/subinstr.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/opcodes/subinstr.md b/docs/opcodes/subinstr.md index 82a8e273af5..362969c61d1 100644 --- a/docs/opcodes/subinstr.md +++ b/docs/opcodes/subinstr.md @@ -34,7 +34,7 @@ The called instrument's p2 and p3 values will be identical to the host instrumen > :memo: **Note** > -> Only the `p4` style accessors can read the actual parameter values passed to subinstruments. In a subinstrument, `p(4)` returns the host's `p4`, and so does `passign`. Furthermre, `pcount` returns the host's parameter count, not the subinsturment's. +> Only unparanthesized accessors like `p4` can read the actual parameter values passed to subinstruments. In contrast, in a subinstrument, opcodes calls relating to parameters like `p(4)` return the host's `p4`, and so does `passign`. Furthermre, `pcount` returns the host's parameter count, not the subinsturment's. ## Examples From 34f711e62d84d945e853c3953b1cbf0fca274497 Mon Sep 17 00:00:00 2001 From: eleses Date: Wed, 6 Aug 2025 19:49:56 +0300 Subject: [PATCH 3/3] properly spell "unparenthesized" --- docs/opcodes/subinstr.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/opcodes/subinstr.md b/docs/opcodes/subinstr.md index 362969c61d1..f44350d5849 100644 --- a/docs/opcodes/subinstr.md +++ b/docs/opcodes/subinstr.md @@ -34,7 +34,7 @@ The called instrument's p2 and p3 values will be identical to the host instrumen > :memo: **Note** > -> Only unparanthesized accessors like `p4` can read the actual parameter values passed to subinstruments. In contrast, in a subinstrument, opcodes calls relating to parameters like `p(4)` return the host's `p4`, and so does `passign`. Furthermre, `pcount` returns the host's parameter count, not the subinsturment's. +> Only unparenthesized accessors like `p4` can read the actual parameter values passed to subinstruments. In contrast, in a subinstrument, opcodes calls relating to parameters like `p(4)` return the host's `p4`, and so does `passign`. Furthermre, `pcount` returns the host's parameter count, not the subinsturment's. ## Examples