Add Clips in the Editor chapter

[ardour-manual] / include / the-region-list.html

diff --git a/include/the-region-list.html b/include/the-region-list.html
index 2c3fb54b0737d4ce95ec6541e131c0b86f498ec3..e9183d9fa031d1f96345f0cfec42e6e272cdd8b3 100644 (file)
--- a/include/the-region-list.html
+++ b/include/the-region-list.html
@@ -1,81 +1,43 @@
 
-
-
 <p>
-
-  The region list shows all the regions in the session. The left-hand column gives the region name, and there are a range of times given for information:
-
+  The region list shows all the regions in the session, with infos about them 
+  in a tabular form. Any column caption can be clicked to sort the list
+  according to the clicked value:
 </p>
 
-
-
-<dl>
-
-  <dt>Position</dt><dd>position of the start of the region on the global timeline</dd>
-
-  <dt>End</dt><dd>position of the region on the global timeline</dd>
-
-  <dt>Length</dt><dd>duration of the region</dd>
-
-  <dt>Sync</dt><dd>position of the sync point, relative to the start of region (can be negative)</dd>
-
-  <dt>Fade In</dt><dd>duration of the fade in. Can't be less than 1 ms, to avoid clipping.</dd>
-
-  <dt>Fade Out</dt><dd>duration of the fade out (positive value, &ge; 1 ms).</dd>
-
-</dl>
-
-
+<table class="dl">
+  <tr><th>Name</th><td>The name of the region, can be modified by double-clicking it</td></tr>
+  <tr><th># Ch</th><td>Number of channels for an audio region (0 for MIDI)</td></tr>
+  <tr><th>Tags</th><td>User-added tag text, can be modified by double clicking it</td></tr>
+  <tr><th>Start</th><td>position of the start of the region on the global timeline</td></tr>
+  <tr><th>Length</th><td>duration of the region</td></tr>
+</table>
 
 <p>
-
-  The units used to display those times are those used for the clock, so changing the units on the clocks change the display of this values.
-
+  The time format used for <em>Start</em> and <em>Length</em> follows the <a href="@@editing-clocks">Primary Clock</a> one.
 </p>
 
-
-
 <p>
-
   At the right of the list are four columns of flags that can be altered:
-
 </p>
 
-
-
-<dl>
-
-  <dt>L</dt>
-
-  <dd>whether the region position is locked, so that it cannot be moved.</dd>
-
-  <dt>G</dt>
-
-  <dd>whether the region's position is &lsquo;glued&rsquo; to bars and beats. If so, the region will stay at the same position in bars and beats even if the tempo and/or time signature change.</dd>
-
-  <dt>M</dt>
-
-  <dd>whether the region is muted, so that it will not be heard.</dd>
-
-  <dt>O</dt>
-
-  <dd>whether the region is opaque; opaque regions &lsquo;block&rsquo; regions below them from being heard, whereas &lsquo;transparent&rsquo; regions have their contents mixed with whatever is underneath. </dd>
-
-</dl>
-
-
+<table class="dl">
+  <tr><th>&square;&nbsp;L</th>
+  <td>whether the region position is locked, so that it cannot be moved.</td></tr>
+  <tr><th>&square;&nbsp;G</th>
+  <td>whether the region's position is &lsquo;glued&rsquo; to bars and beats.
+  If so, the region will stay at the same position in bars and beats even if the tempo and/or time signature change.</td></tr>
+  <tr><th>&square;&nbsp;M</th>
+  <td>whether the region is muted, so that it will not be heard.</td></tr>
+  <tr><th>&square;&nbsp;O</th>
+  <td>whether the region is opaque; opaque regions &lsquo;block&rsquo; regions below them from being heard, whereas &lsquo;transparent&rsquo; regions have their contents mixed with whatever is underneath. </td></tr>
+</table>
 
 <p>
-
   Hovering the mouse pointer over a column heading shows a tool-tip which can be handy to remember what the columns are for.
-
 </p>
 
-
-
 <p>
-
   A handy feature of the region list is that its regions can be dragged and dropped into a suitable track in the session.
-
 </p>