From 08ce4eecd9a83d6309a29e27f11fc64eabe8269e Mon Sep 17 00:00:00 2001
From: Ed Ward <edwsaintesprit@hotmail.com>
Date: Sun, 27 Jun 2021 21:09:11 +0200
Subject: [PATCH] Double clicking on track header toggles its size

---
 include/audio-track-controls.html | 24 ++++++++++++++++++++++++
 include/midi-track-controls.html  | 13 +++++++++----
 2 files changed, 33 insertions(+), 4 deletions(-)

diff --git a/include/audio-track-controls.html b/include/audio-track-controls.html
index 6b99969..a7a9afd 100644
--- a/include/audio-track-controls.html
+++ b/include/audio-track-controls.html
@@ -6,6 +6,30 @@
     </figcaption>
 </figure>
 
+<p>
+  Each track shows a <dfn>header section</dfn>, for settings relevant to
+  this track only.
+</p>
+<p>
+  Changing the height of the track can be done either:
+</p>
+<ul>
+  <li>
+	By using the <kbd class="menu">Track &gt; Height</kbd> menu. The 
+    <kbd class="menu">Fit selection (Vertical)</kbd> (default: <kbd>F</kbd>)
+    is particularly useful.</li>
+  <li>
+	By double-clicking an empty space in the track header, to toggle the
+	track's height between the <em>Normal</em> and <em>Largest</em> track
+	heights from this menu. 
+  </li>
+  <li>
+    Or by grabbing the bottom of the track header with a <kbd class="mouse">
+	left</kbd> click and drag.
+
+  </li>
+</ul>
+
 <p>
   At the top-left of the controls is the name of the track, which can be
   edited by double-clicking on it. The new name must be unique within the
diff --git a/include/midi-track-controls.html b/include/midi-track-controls.html
index 72ee046..7f412dc 100644
--- a/include/midi-track-controls.html
+++ b/include/midi-track-controls.html
@@ -1,6 +1,4 @@
 
-<p class=fixme>Item #3 below does not hold in all cases; check to make sure the rest of the content is sane as well</p>
-
 <figure>
 <img src="/images/typical-midi-track-controls.png" alt="A MIDI track header">
 <figcaption class="center">MIDI track header, stretched to show normally hidden controls.</figcaption>
@@ -21,14 +19,21 @@
   <li>An External MIDI Device combobox can appear, for selecting <a
   href="@@patch-change#midnam">MIDNAMs</a></li>
   <li>An External Device Mode combobox can appear, for selecting an external
-  device's mode</li>
+  device's mode, in case no relevant External MIDI Device has been selected</li>
 </ol>
 
 <p class="note">
   To show the full set of MIDI track controls, the <a
   href="@@track-height">track height</a> must be increased beyond the default
   height. MIDI tracks will show only a few of the control elements when there
-  is insufficient vertical space. Further, the External MIDI Device and
+  is insufficient vertical space. As for <a href="@@audio-track-controls">Audio
+  tracks</a>, this can be done by either toggling the
+  track's full screen mode (<kbd class="menu">Track &gt; Height &gt; Fit
+  selection (Vertical)</kbd>, default : <kbd>F</kbd>, or by simply
+  double-clicking an empty space in the track header, to increase the track's
+  height.
+  <br>
+  Further, the External MIDI Device and
   External Device Mode comboboxes will <strong>not</strong> appear if there is
   a synth plugin on the track that comes with an associated <a
   href="@@patch-change#midnam">MIDNAM</a>.
-- 
2.37.2