Arrangement list + Sections update

include/arrangement-list.html

@@ -0,0 +1,52 @@
+<p>
+  The Arrangement list shows all range sections in the session, with start and
+  end time for each of them in the time domain of the first clock.
+</p>
+
+<figure>
+  <img style="width:50%;" src="/images/arrangement-list.png"
+  alt="Arrangement list">
+  <figcaption>Arrangement list</figcaption>
+</figure>
+
+<p>
+	Selecting a range section in the list opens a small window below that
+	display range section timing: end, start, and duration. Its time domain
+	can be selected in the right-click menu.
+</p>
+
+<figure>
+  <img style="width:50%;" src="/images/arrangement-list-selected-section.png"
+  alt="Selected range section in the Arrangement list">
+  <figcaption>Selected range section in the Arrangement list</figcaption>
+</figure>
+
+<h2>Copying and pasting range sections</h2>
+
+<p>
+	An existing range section can be easily copied and pasted using this list
+	editor. Simply pick a range section and drag it up or down to insert
+	between two other existing sections, before the first section, or after
+	the last section.
+</p>
+
+<h2>Renaming range sections</h2>
+
+<p>
+	To rename an existing range section, either double-click its name or
+	right-click it and select the
+	<kbd class="menu">Rename the selected Section</kbd> menu item, then input
+	the new caption of the range section, and press <kbd>Enter</kbd> to confirm.
+</p>
+
+<p>
+	To cancel the renaming before the confirmation, press the <kbd>Esc</kbd>
+	key.
+</p>
+
+<h2>Removing range sections</h2>
+
+<p>
+	To remove an existing range section, either press the <kbd>Del</kbd> key or
+	select the <kbd class="menu">Remove the selected Section</kbd> menu item.
+</p>

include/ruler.html

@@ -76,6 +76,10 @@
     <th><dfn>Cue Markers</dfn></th>
     <td>allows triggering entire cues from the grid in the <em>Cue</em>window</td>
   </tr>
+  <tr>
+    <th><dfn>Arrangement</dfn></th>
+    <td>allows creating range sections like a verse, a chorus, a bridge etc.</td>
+  </tr>
   <tr>
     <th><dfn>Video Timeline</dfn></th>
     <td>shows thumbnails of the <a href="@@video-timeline-and-monitoring">video</a>

include/sections.html

@@ -4,9 +4,28 @@
 	Common examples of a section are a verse, a chorus, or a bridge in a song.
 </p>
 
+<figure>
+  <img style="width:100%;" src="/images/arrangement-example.png"
+  alt="Arrangement example">
+  <figcaption>Arrangement example</figcaption>
+</figure>
+
 <p>
-	Currently, sections are exposed as editor actions that are available
-	when a range is selected on the timeline:
+	Sections are represented in two ways in the editor window:
+</p>
+
+<ol>
+	<li>
+		The <a href="@@arrangement-ruler">Arrangement timeline ruler</a>
+	</li>
+	<li>
+		The <a href="@@arrangement-list">Arrangement sidebar tab</a>
+	</li>
+</ol>
+
+<p>
+	There are also several commands in the main <kbd class="menu">Edit</kbd>
+	menu:
 </p>
 
 <ul>

master-doc.txt

@@ -597,6 +597,14 @@ uri: ardours-interface/editor-lists
 part: chapter
 ---
 
+---
+title: The Tracks and Busses List
+include: the-tracks-and-busses-list.html
+link: the-tracks-and-busses-list
+uri: ardours-interface/editor-lists/tracks-and-busses-list
+part: subchapter
+---
+
 ---
 title: The Region List
 include: the-region-list.html
@@ -606,10 +614,10 @@ part: subchapter
 ---
 
 ---
-title: The Tracks and Busses List
-include: the-tracks-and-busses-list.html
-link: the-tracks-and-busses-list
-uri: ardours-interface/editor-lists/tracks-and-busses-list
+title: The Arrangement list
+include: arrangement-list.html
+link: arrangement-list
+uri: ardours-interface/editor-lists/arrangement-list
 part: subchapter
 ---