From a7befd2e180e9cc2964e7afe339fce2b36ba2bfc Mon Sep 17 00:00:00 2001
From: tildearrow <me@tildearrow.org>
Date: Sun, 12 Nov 2023 22:52:22 -0500
Subject: [PATCH 1/2] fix osc.md

---
 doc/8-advanced/osc.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/doc/8-advanced/osc.md b/doc/8-advanced/osc.md
index db625e71c..de58d70f4 100644
--- a/doc/8-advanced/osc.md
+++ b/doc/8-advanced/osc.md
@@ -1,6 +1,6 @@
 # oscilloscope
 
-the Oscilloscope shows the waveform of the mix of all currently playing sounds.
+the Oscilloscope shows the audio output as a waveform.
 
 ![oscilloscope view](osc.png)
 

From 5c199315e0cf5fa88361e9347030cc4b4eb0f533 Mon Sep 17 00:00:00 2001
From: tildearrow <me@tildearrow.org>
Date: Sun, 12 Nov 2023 23:01:44 -0500
Subject: [PATCH 2/2] X-Y osc documentation

---
 doc/8-advanced/README.md |  1 +
 doc/8-advanced/xyosc.md  | 17 +++++++++++++++++
 2 files changed, 18 insertions(+)
 create mode 100644 doc/8-advanced/xyosc.md

diff --git a/doc/8-advanced/README.md b/doc/8-advanced/README.md
index 97ecd6f2c..4a9512823 100644
--- a/doc/8-advanced/README.md
+++ b/doc/8-advanced/README.md
@@ -18,6 +18,7 @@ as listed in the "Window" menu:
 
 - [piano](piano.md)
 - [oscilloscope](osc.md)
+- [oscilloscope (X-Y)](xyosc.md)
 - [oscilloscopes (per-channel)](chanosc.md)
 - [clock](clock.md)
 - [register view](regview.md)
diff --git a/doc/8-advanced/xyosc.md b/doc/8-advanced/xyosc.md
new file mode 100644
index 000000000..5c8608243
--- /dev/null
+++ b/doc/8-advanced/xyosc.md
@@ -0,0 +1,17 @@
+# oscilloscope (X-Y)
+
+also called "vectorscope", this is similar to the normal oscilloscope in that it draws audio output as a waveform, but instead of being one-dimensional and going from left to right, it is plotted in two dimensions (usually X represents left output and Y represents right output).
+
+(TODO: image)
+
+right-clicking the X-Y oscilloscope window displays settings:
+- **X Channel**: the output channel which will affect the X (left-right) axis. 1 is left.
+  - **Invert**: flips the axis.
+- **Y Channel**: the output channel which will affect the Y (up-down) axis. 2 is right.
+  - **Invert**: flips the axis.
+- **Zoom**: changes amplitude, making the plot bigger or smaller.
+- **Samples**: the maximum number of samples to use for plotting.
+  - this setting may be replaced by another or removed in a future version.
+- **Decay Time (ms)**: sets how long it takes for the points/lines to fade away.
+- **Intensity**: changes the brightness of the dots/lines.
+- **Line Thickness**: sets how thick lines are.