From 0f901f71d5e3ffd8720a9cfa520f80bd47655081 Mon Sep 17 00:00:00 2001
From: RT
Date: Sun, 26 Jul 2026 10:23:42 -0500
Subject: [PATCH] Release notes: document which -tmon positions apply in each
MFD mode
-tmon has four positions (main, radar, MFD1, MFD2) but only the first two do
anything in the spanned modes. Positions 3 and 4 write to the mode 4 MFD device
slots, which -tmfds 1 and -tmfds 3 never read -- they drive both MFDs from one
wide display instead. The switch accepts them either way, so an operator could
reasonably assume they had taken effect.
Also states what was previously undocumented: the spanned MFD display itself
cannot be assigned with -tmon at all. It is chosen automatically as the first
display advertising a 1280x480 mode, which is a distinctive enough signature that
it normally lands correctly. Noted that it can be added if anyone needs to force it.
Adds a per-mode table, a pointer to gos-displays.txt for diagnosing a display that
lands in the wrong place, and a qualifier on the -tmon row of the switch summary.
No code changes -- documentation only.
Co-authored-by: Claude Opus 5 (Anthropic)
Co-authored-by: GitHub Copilot
---
RELEASE-NOTES-5.1.0b_RC1.html | 49 ++++++++++++++++++++++++++++++++++-
RELEASE-NOTES-5.1.0b_RC1.md | 24 ++++++++++++++++-
2 files changed, 71 insertions(+), 2 deletions(-)
diff --git a/RELEASE-NOTES-5.1.0b_RC1.html b/RELEASE-NOTES-5.1.0b_RC1.html
index 5bfe5b1d..cb94988e 100644
--- a/RELEASE-NOTES-5.1.0b_RC1.html
+++ b/RELEASE-NOTES-5.1.0b_RC1.html
@@ -176,6 +176,53 @@ order main, radar, MFD 1, MFD 2:
Use 0 in any position to leave that one on automatic -- -tmon 2,1,0,0 swaps only main and radar.
Leave the switch off entirely and everything is detected automatically, which is correct on
most pods.
+Which positions apply depends on the MFD mode:
+
+
+
+| Position |
+Display |
+-tmfds 4 (split) |
+-tmfds 1 / -tmfds 3 (spanned) |
+
+
+
+
+| 1st |
+Main |
+applies |
+applies |
+
+
+| 2nd |
+Radar |
+applies |
+applies |
+
+
+| 3rd |
+MFD 1 |
+applies |
+ignored |
+
+
+| 4th |
+MFD 2 |
+applies |
+ignored |
+
+
+
+In the spanned modes the first two positions work normally, so you can still correct main and
+radar. The 3rd and 4th positions are accepted but have no effect, because the spanned modes
+drive both MFDs from a single wide display rather than two separate ones.
+The spanned MFD display itself cannot be assigned with -tmon. It is picked automatically
+as the first display that reports a 1280x480 mode -- a distinctive signature that a spanned
+MFD pair produces and ordinary monitors do not, so it normally lands on the right one. If you
+ever need to force it, ask and it can be added.
+If a display comes up in the wrong place, check gos-displays.txt next to the game (see
+section 8). It lists every display found, which role each was given, and whether each -tmon
+position was accepted or ignored.
5. 'Mechs and content
Six rookie 'Mechs instead of four
@@ -301,7 +348,7 @@ start. Previously such failures were completely silent. Include this file with a
-tmon a,b,c,d |
-Force monitor order: main, radar, MFD1, MFD2 |
+Force monitor order: main, radar, MFD1, MFD2. Positions 3 and 4 apply only to -tmfds 4 |
Automatic detection |
diff --git a/RELEASE-NOTES-5.1.0b_RC1.md b/RELEASE-NOTES-5.1.0b_RC1.md
index a68e3a7c..ca0a13d0 100644
--- a/RELEASE-NOTES-5.1.0b_RC1.md
+++ b/RELEASE-NOTES-5.1.0b_RC1.md
@@ -195,6 +195,28 @@ Use `0` in any position to leave that one on automatic -- `-tmon 2,1,0,0` swaps
**Leave the switch off entirely and everything is detected automatically**, which is correct on
most pods.
+**Which positions apply depends on the MFD mode:**
+
+| Position | Display | `-tmfds 4` (split) | `-tmfds 1` / `-tmfds 3` (spanned) |
+|---|---|---|---|
+| 1st | Main | applies | applies |
+| 2nd | Radar | applies | applies |
+| 3rd | MFD 1 | applies | ignored |
+| 4th | MFD 2 | applies | ignored |
+
+In the spanned modes the first two positions work normally, so you can still correct main and
+radar. The 3rd and 4th positions are accepted but have no effect, because the spanned modes
+drive both MFDs from a single wide display rather than two separate ones.
+
+**The spanned MFD display itself cannot be assigned with `-tmon`.** It is picked automatically
+as the first display that reports a 1280x480 mode -- a distinctive signature that a spanned
+MFD pair produces and ordinary monitors do not, so it normally lands on the right one. If you
+ever need to force it, ask and it can be added.
+
+If a display comes up in the wrong place, check `gos-displays.txt` next to the game (see
+section 8). It lists every display found, which role each was given, and whether each `-tmon`
+position was accepted or ignored.
+
---
## 5. 'Mechs and content
@@ -346,7 +368,7 @@ start. Previously such failures were completely silent. Include this file with a
| Switch | Purpose | If you leave it off |
|---|---|---|
| `-tmfds 4` | Two separate 640x480 MFD monitors | Existing MFD mode unchanged |
-| `-tmon a,b,c,d` | Force monitor order: main, radar, MFD1, MFD2 | Automatic detection |
+| `-tmon a,b,c,d` | Force monitor order: main, radar, MFD1, MFD2. Positions 3 and 4 apply only to `-tmfds 4` | Automatic detection |
| `-tbaud ` | COM1 speed for replica RIO boards | Original board speed |
| `-fps` | Write a performance log | No log, no overhead |
| `-help` | Show the full switch reference and exit | Game starts normally |