Major reordering of Part IV, including some section cleanup.

[ardour-manual] / include / controlling-track-ordering.html

diff --git a/include/controlling-track-ordering.html b/include/controlling-track-ordering.html
index 3961ea3d56cf44268585bd66f69ab3d764cfe9af..7e8e2bda5fb4f5a9851b74422856e2666051adc5 100644 (file)
--- a/include/controlling-track-ordering.html
+++ b/include/controlling-track-ordering.html
@@ -3,18 +3,87 @@
   Ardour does not impose any particular ordering of tracks and busses in 
   either the editor or mixer windows. The default arrangements are as follows:
 </p>
   Ardour does not impose any particular ordering of tracks and busses in 
   either the editor or mixer windows. The default arrangements are as follows:
 </p>

+

 <p>
 <p>

-  In the <dfn>Editor</dfn>, the Master bus will always be on top unless
+  In the <dfn>Editor</dfn> window, the Master bus will always be on top unless

   hidden. Tracks and busses will appear in their initial order, from top to
   hidden. Tracks and busses will appear in their initial order, from top to

-  bottom. The monitor section (if used) will never be visible in the editor
-  window.
+  bottom. The monitor section (if used) is never visible in the editor window.

 </p>
 </p>

+
+<p>
+  In the <dfn>Mixer</dfn> window, the tracks and busses will be displayed in
+  their initial order, from left to right. The Master bus is always on the far
+  right and occupies its own pane, so that it is always visible no matter how
+  many other mixer strips are present. If a Monitor section is used, it shows
+  up at the right edge of the mixer window; it can also be torn off into a
+  separate window.
+</p>
+
+<h2>Reordering Tracks</h2>
+
+<p>
+  The <dfn>track ordering</dfn> of the Editor and Mixer is
+  <dfn>synchronized</dfn>: if you reorder in one window, the ordering in the
+  other window will follow.
+</p>
+
+<h3>Reordering in the Editor Window</h3>
+
+<p>
+  Select the tracks to be moved, then use <kbd class="menu">Track &gt; Move Selected Tracks Up</kbd> (shortcut: <kbd class="mod1">&uarr;</kbd>) or <kbd class="menu">Track &gt; Move Selected Tracks Down</kbd> (shortcut: <kbd class="mod1">&darr;</kbd>).
+</p>
+
+<p>
+  Alternatively, the <a href="@@the-tracks-and-busses-list"><kbd
+  class="menu">Tracks &amp; Busses</kbd> panel of the Editor Lists</a> can be
+  used, if visible. Here, tracks and busses can be freely dragged-and-dropped
+  into any desired order.
+</p>
+
+<h3>Reordering in the Mixer Window</h3>
+
+<p>
+  Within the <kbd class="menu">Strips</kbd> pane at the top left of the Mixer
+  window, tracks and busses can be freely dragged-and-dropped into any desired
+  order.
+</p>
+
+<h3>"Collecting" Group Members</h3>
+
+<p>
+  Tracks and Busses that are members of a group can be reordered so that they
+  display contiguously within the Editor and Mixer windows. <kbd
+  class=mouse>Right</kbd>-click on the group tab and choose <kbd
+  class="menu">Collect</kbd>.
+</p>
+
+<h2>Ordering of New Tracks</h2>
+
+<p>
+  When <dfn>adding new tracks</dfn>, the current selection determines their
+  placement. New tracks will be placed after the rightmost (in the mixer) or
+  bottom-most (in the editor) selected track. If no tracks are selected, new
+  tracks will be added at the end.
+</p>
+
+<p class="note">
+  Because new tracks are automatically selected, they can be quickly reordered
+  in the editor window via the keyboard shortcuts after adding them.
+</p>
+
+<h2>Track Ordering and Remote Control IDs</h2>
+  
+<p>
+  Every track and bus in Ardour is assigned a <dfn>remote control ID</dfn>. 
+  When a <a href="@@control-surfaces">control surface</a> or any other
+  remote control is used to control Ardour, these IDs are used to identify 
+  which track(s) or buss(es) are the intended target of incoming commands.
+</p>
+

 <p>
 <p>

-  In the <dfn>Mixer</dfn>, the tracks and busses will be displayed in their
-  initial order, from left to right. The Master bus is always on the far
-  right and occupies its own pane, so that it is always visible no matter
-  how you scroll the other mixer strips. If a Monitor section is used, 
-  it shows up at the right edge of the mixer window, from where it can be
-  torn off into a separate window.
+  Remote IDs are assigned to tracks and buses in the order that they appear in
+  the mixer window from left to right, starting from #1; manual assignment of
+  remote IDs is not possible. The master bus and monitor section can be
+  accessed by name.

 </p>
 
 </p>