Track automation 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/arrangement-ruler.html

@@ -0,0 +1,54 @@
+<p>
+	The Arrangement ruler allows creating range sections that separate
+	meaningful parts of songs form each other and easily creating their copies.
+	An example of using range sections would recording an intro, then the first
+	verse, then the chorus, then recording the second verse, the copy/pasting
+	the chorus with all tracks and automation to follow the second verse.
+</p>
+
+<p>
+	On the screenshot below, there's a typical setup with an intro, a verse,
+	a chorus, a second verse, a chorus, a bridge, a chorus, and an outro:
+</p>
+
+<figure>
+  <img style="width:100%;" src="/images/arrangement-example.png"
+  alt="Arrangement example">
+  <figcaption>Arrangement example</figcaption>
+</figure>
+
+<h2 id="creating-range-sections">Creating range sections</h2>
+
+<p>
+	To start a new range section, press <kbd>Ctrl</kbd> and single-click on the
+	Arrangement ruler. Ardour will create a new range section marker named
+	'verseN', where N is a number starting at 1 and incremented each time you
+	create a new range section marker.
+</p>
+
+<p>
+	Because range section assume ranges, a second marker should be created
+	the same way to define the end of the range. Thus, as the song ends with
+	an 'outro' section, you will need to create the last range section marker
+	at the end of the song and give it a name like 'end'.
+</p>
+
+<h2 id="editing-range-sections">Editing range sections</h2>
+
+<p>
+	To move the position of a range section marker, single-click and drag it
+	left or right.
+</p>
+
+<p>
+	To rename a range section marker, either double-click it, or right-click,
+	then select the <kbd class="menu">Rename…</kbd> menu item. This will open
+	a dialog for editing the caption/name of the range section.	
+</p>
+
+<h2 id="removing-range-sections">Removing range sections</h2>
+
+<p>
+	To remove a range section marker, right-click it ans select the
+	<kbd class="menu">Remove</kbd> menu item.
+</p>

include/creating-location-markers.html

@@ -152,11 +152,4 @@
       This prevents a marker from being accidentally moved elsewhere.
     </td>
   </tr>
-  <tr>
-    <th>Glue to Bars and Beats</th>
-    <td>
-      When this option is enabled, the marker maintains its position in bars
-      and beats even if there are changes in tempo and meter.
-    </td>
-  </tr>
 </table>

include/creating-range-markers.html

@@ -151,13 +151,6 @@
       maximized yet visible entirely within Ardour's window.
     </td>
   </tr>
-  <tr>
-    <th>Glue to Bars and Beats</th>
-    <td>
-      When this option is enabled, the marker maintains its position in bars
-      and beats even if there are changes in tempo and meter.
-    </td>
-  </tr>
   <tr>
     <th>Loudness Assistant…</th>
     <td>

include/cue-markers.html

@@ -107,10 +107,4 @@
   	<td>This will move the selected cue marker to the current position of the
   	Playhead.</td>
   </tr>
-  <tr>
-  	<th>Glue to Bars and Beats</th>
-  	<td>If this option is enabled, the cue marker will maintain its position in
-  	bars and beats even if there are changes in tempo and time signature.
-  	</td>
-  </tr>
 </table>

include/list-of-menu-actions.html

@@ -1012,7 +1012,6 @@
  <tr><th><kbd class="osc">Region/toggle-region-polarity</kbd></th><td>Invert Polarity</td></tr>
  <tr><th><kbd class="osc">Region/toggle-region-gain-envelope-active</kbd></th><td>Envelope Active</td></tr>
  <tr><th><kbd class="osc">Region/toggle-region-lock</kbd></th><td>Lock</td></tr>
- <tr><th><kbd class="osc">Region/toggle-region-lock-style</kbd></th><td>Glue to Bars and Beats</td></tr>
  <tr><th><kbd class="osc">Region/toggle-region-mute</kbd></th><td>Mute</td></tr>
  <tr><th><kbd class="osc">Region/toggle-region-video-lock</kbd></th><td>Lock to Video</td></tr>
  <tr><th><kbd class="osc">Region/transform-region</kbd></th><td>Transform...</td></tr>

include/marker-context-menu.html

@@ -23,9 +23,6 @@
   <tr><th>Lock</th>
   <td>If this is ticked, it will be impossible to drag the marker's
   position; useful if you want to prevent accidental movements.</td></tr>
-  <tr><th>Glue to Bars and Beats</th>
-  <td>If this is ticked, the marker will maintain its position in bars and
-  beats even if there are changes in tempo and meter.</td></tr>
   <tr><th>Remove</th>
   <td>Removes the marker. </td></tr>
 </table>

include/midi-list-editor.html

@@ -1,6 +1,6 @@
 
 <figure class="right">
-  <img src="/images/midi-list-editor.png" alt="The MIDI List Editor window">
+  <img height="400px" src="/images/midi-list-editor.png" alt="The MIDI List Editor window">
   <figcaption>
     The MIDI List Editor window
   </figcaption>

include/midi-velocity-editing.html

@@ -0,0 +1,111 @@
+<p>
+	Velocities of notes can be edited on both the timeline by selecting notes
+	and scrolling the mouse wheel above them, or by editing representations of
+	velocities in a dedicated Velocity automation lane.
+</p>
+
+<h2>Velocity lane</h2>
+
+<p>
+	To open the velocity lane, right-click on the MIDI track header, select
+	<kbd class="menu">Automation &gt; Velocity</kbd>.
+</p>
+
+<figure>
+<img width="100%" src="/images/velocity-lane.png" alt="Velocity lane below a MIDI track">
+<figcaption class="center">Velocity lane below a MIDI track</figcaption>
+</figure>
+
+<p>
+	Each notes's velocity is represented as a lollipop-shaped object.
+	Each lollipop object has two characteristics that represent the velocity
+	value:
+</p>
+
+<ol>
+	<li>
+		The vertical position: the lower the lollipop head is, the lower is the
+		velocity value, and vice versa.
+	</li>
+	<li>
+		The color: just like with notes on the timeline, it goes from pale yellow
+		(low velocity) to bright red (high velocity).
+	</li>
+</ol>
+
+<h2>Editing single notes</h2>
+
+<p>
+	To edit a single note's velocity <em>on the timeline</em>, click to select
+	the note in either Draw or Edit mode, then scroll the mouse wheel up or
+	down. The new value will be displayed in an overlay.
+</p>
+
+<video width="75%" controls>
+  <source src="/videos/midi-velocity-timeline-edit-single-note.mp4" type="video/mp4">
+</video>
+
+<p>
+	To edit a single note'velocity <em>on the velocity lane</em>, switch to the
+	Edit mode, grab the note's velocity lollipop, then drag it up or down:
+</p>
+
+<video width="75%" controls>
+  <source src="/videos/midi-velocity-lane-edit-single-note.mp4" type="video/mp4">
+</video>
+
+<p>
+	To edit a single note in a chord <em>on the velocity lane</em>, switch to the
+	Edit mode, select the note in the timeline, then draw its velocity lollipop up
+	or down:
+</p>
+
+<video width="75%" controls>
+  <source src="/videos/midi-velocity-lane-edit-note-in-chord.mp4" type="video/mp4">
+</video>
+
+<h2>Editing multiple notes</h2>
+
+<p>
+	To edit velocities of multiple notes <em>on the timeline</em>, in the Edit
+	mode, do a rubberband selection tp select adjucent notes or press
+	<kbd>Ctrl</kbd> to select non-adjucent notes (<kbd>Shift</kbd> will select
+	entire chords), then hover one of the selected notes and rotate the mouse
+	wheel up or down. Velocities will be adjusted in all selected notes
+	relatively, i.e. by the same amount.
+</p>
+
+<video width="75%" controls>
+  <source src="/videos/midi-velocity-timeline-edit-multiple-notes.mp4" type="video/mp4">
+</video>
+
+<p>
+	It's also possibly to edit the velocity of multiple notes in a MIDI region
+	by drawing free or straight lines in the velocity lane.
+</p>
+
+<p>
+	To draw a free line, in Draw mode, click and draw the mouse pointer over the
+	velocity lane from left to right:
+</p>
+
+<video width="75%" controls>
+  <source src="/videos/midi-velocity-lane-draw-freely.mp4" type="video/mp4">
+</video>
+
+<p>
+	To draw a straight line, in Draw mode, press and hold <kbd>Ctrl</kbd>, then
+	click and drag the mouse pointer to draw a straight line. Once you get the
+	line you expected, release the mouse button and then the <kbd>Ctrl</kbd> key.
+</p>
+
+<video width="75%" controls>
+  <source src="/videos/midi-velocity-lane-draw-straight-iines.mp4" type="video/mp4">
+</video>
+
+<p>
+	Just like with automation lines, you can also combine free and straight lines
+	in one go. Draw a free line, then press <kbd>Ctrl</kbd> to draw straight line,
+	release the <kbd>Ctrl</kbd> key, continue drawing free lines, release the mouse
+	button when you are'done drawing.
+</p>

include/newopen-session-dialog.html

@@ -37,23 +37,24 @@
   </figcaption>
 </figure>
 
+<p>
+  This page allows to type in the name of a session, select a folder to save it in, and
+  optionally use an existing <a href="@@session-templates">template</a>. The different
+  templates, both the "factory" ones and the ones created by the user, are easily
+  available on the left-side panel.
+</p>
+
 <figure class="right">
-  <img class="mini" src="/images/template_setup.png" alt="One of the Template Setup Dialogs">
+  <img class="mini" src="/images/template-setup.png" alt="Template Setup dialog">
   <figcaption>
-    One of the Template Setup Dialogs
+    Template Setup dialog for the Advanced template
   </figcaption>
 </figure>
 
 <p>
-  This page allows to type in the name of a session, select a folder to save it in, and
-  optionally use an existing <a href="@@session-templates">template</a>.
-</p>
-<p>
-  The different templates, both the "factory" ones and the ones created by the user,
-  are easily available on the left-side panel. Depending on the chosen template,
-  a specific Template Settings window may be shown, allowing the user to fine-tune
-  the details of the template and/or choose between the different options of the
-  template.
+  Depending on the chosen template, a specific Template Setup window may be shown,
+  allowing the user to fine-tune the details of the template and/or choose between
+  the different options of the template.
 </p>
 
 <p>
@@ -96,5 +97,8 @@
   <a href="@@audio-midi-setup">Audio/MIDI Setup</a> will be shown.
 </p>
 
-
-
+<p>
+  The New Session dialog also allows selecting session's time domain&nbsp;— either
+  audio time or beat (musical) time. This defines the defaut selection of visible
+  timeline rulers and units in which various markers operate in.
+</p>

include/other-toolbar-items.html

@@ -9,7 +9,7 @@
 </figure>
 
 <p>
-  This section show information about the latency compensation Ardour sets
+  This section shows information about the latency compensation Ardour sets
   to align all signals in time whatever their route (and processing applied).
 </p>
 

include/punch-range.html

@@ -120,13 +120,6 @@
       maximized yet visible entirely within Ardour's window.
     </td>
   </tr>
-  <tr>
-    <th>Glue to Bars and Beats</th>
-    <td>
-      When this option is enabled, the marker maintains its position in bars
-      and beats even if there are changes in tempo and meter.
-    </td>
-  </tr>
   <tr>
     <th>Loudness Assistant…</th>
     <td>

include/quantize-midi.html

@@ -1,6 +1,6 @@
 
 <figure>
-    <img src="/images/quantize.png" alt="the Quantize dialog">
+    <img width="50%" src="/images/quantize.png" alt="the Quantize dialog">
     <figcaption>
       The Quantize dialog
     </figcaption>

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>

include/selection-and-punch-clocks.html

@@ -40,7 +40,7 @@
   to the Punch range, and allow to use only one of the two punch boundaries, or both:
 </p>
 <table class="dl">
-  <tr><th>In only</th><td>Records from the In marker on, without a end boundary</td></tr>
+  <tr><th>In only</th><td>Records from the In marker on, without an end boundary</td></tr>
   <tr><th>Out only</th><td>Records until the Out marker, without a beginning boundary</td></tr>
   <tr><th>In <em>and</em> Out</th><td>Records only between the In and Out markers</td></tr>
 </table>

include/session-properties.html

@@ -317,6 +317,35 @@
 	</li>
 </ul>
 
+<h2 id="properties-midi">MIDI</h2>
+
+<ul>
+	<li>
+		<dfn>Draw tool creates opaque MIDI regions</dfn>: if selected, creates
+		MIDI regions that, when placed on top of other regions, don't mix with
+		content below during playback.
+	</li>
+	<li>
+		<dfn>MIDI region copies are independent</dfn>: if selected, when a MIDI
+		region is copied or duplicated, the new region is not linked to the
+		region it was copied from. If it is not selected, the copied regions
+		are linked and any editing done on one of the linked regions changes
+		all of the linked regions.
+	</li>
+	<li>
+		<dfn>Policy for handling overlapping notes on the same MIDI channel:</dfn>
+		selects how Ardour reacts to possibly conflicting MIDI notes:
+			<ul>
+				<li>never allow them</li>
+				<li>don't do anything in particular</li>
+				<li>replace any overlapped existing	notes</li>
+				<li>shorten the overlapped existing note</li>
+				<li>shorten	the overlapping new note</li>
+				<li>replace both overlapping notes with a	single note</li>
+			</ul>
+	</li>
+</ul>
+
 <h2 id="properties-misc">Misc</h2>
 
 <p>
@@ -325,44 +354,12 @@
 
 <ul>
 	<li>
-		<dfn>MIDI Options</dfn>
+		<dfn>Miscellaneous Options</dfn>
 		<ul>
 			<li>
-				<dfn>Draw tool creates opaque MIDI regions</dfn>: if selected, creates
-				MIDI regions that, when placed on top of other regions, don't mix with
-				content below during playback.
-			</li>
-			<li>
-				<dfn>MIDI region copies are independent</dfn>: if selected, when a MIDI
-				region is copied or duplicated, the new region is not linked to the
-				region it was copied from. If it is not selected, the copied regions
-				are linked and any editing done on one of the linked regions changes
-				all of the linked regions.
-			</li>
-			<li>
-				<dfn>Policy for handling overlapping notes on the same MIDI channel:</dfn>
-				selects how Ardour reacts to possibly conflicting MIDI notes:
-					<ul>
-						<li>never allow them</li>
-						<li>don't do anything in particular</li>
-						<li>replace any overlapped existing	notes</li>
-						<li>shorten the overlapped existing note</li>
-						<li>shorten	the overlapping new note</li>
-						<li>replace both overlapping notes with a	single note</li>
-					</ul>
-			</li>
-		</ul>
-	</li>
-	<li>
-		<dfn>Glue to Bars and Beats</dfn>
-		<ul>
-			<li>
-				<dfn>Glue new markers to bars and beats</dfn>: if checked, a newly
-				created marker will always be placed at the nearest musical time
-				instead of right where the mouse pointer is.
-			</li>
-			<li>
-				<dfn>Glue new regions to bars and beats</dfn>: same as above, for regions.
+				<dfn>Default time domain</dfn>: allows selecting either audio (wallclock)
+				time, or musical (beats) time. In an already opened session, this changes
+				what units various markers operate in.
 			</li>
 		</ul>
 	</li>

include/tempo-ruler.html

@@ -1,14 +1,16 @@
 <p>
   The Tempo ruler allows changing tempo within one session, either abruptly or
   gradually over time. This is done by placing tempo markers on the ruler and
-  setting up how exactly the transition happens.
+  setting up how exactly the transition happens. Alternatively, in the
+  <a href="/ardours-interface/the-toolbox#grid">Grid mode</a>, markers can be
+  added and edited directly on the timeline.
 </p>
 
 <p>
   On the screenshot below, there are 4 bars of music at 120bpm starting at bar 27,
   then the tempo changes abruptly to 140bpm and goes on for another 4 bars at that
   tempo, then abruptly changes back to 120bpm and within the next 4 bars gradually
-	goes back to 140bpm, then continues at 140bpm until the end of the session.
+  goes back to 140bpm, then continues at 140bpm until the end of the session.
 </p>
 
 <figure>
@@ -17,46 +19,10 @@
   <figcaption>Changes in tempo over time</figcaption>
 </figure>
 
-<h2>Tempo ruler modes</h2>
-
-<p>
-	The Tempo ruler has two modes: editing tempo and mapping tempo. The mode can
-	be selected in the <kbd class="menu">Edit &gt; Tempo</kbd> menu.
-	Additionally, users can select which one should be enabled by default
-	<kbd class="menu">Edit &gt; Preferences &gt; Metronome &gt; Default tempo
-	ruler state for new sessions</kbd>.
-</p>
-
-<p>
-	The Map Tempo mode is best suited for cases when there is a live recording
-	of an instrument or multiple instruments, with some tempo imperfections. So
-	before more instruments are added, e.g. MIDI-programmed drums, the tempo map
-	needs to be adjusted to match the actual performance. In this mode, MIDI data
-	is not adjusted for tempo map changes, so if the live recording contains
-	both audio and MIDI tracks, the notes will stay exactly where they are.
-	Additionally, tweaking tempo markers does not change the wall clock position
-	of other tempo markers.
-</p>
-
-<figure>
-  <img style="width:75%;" width="50%" src="/images/map-tempo-example.png"
-  alt="An example of mapping tempo to performance">
-  <figcaption>An example of mapping tempo to performance</figcaption>
-</figure>
-
-<p>
-	The Change Tempo mode is better suited for cases when the musician either
-	starts a session from scratch and creates the tempo map at the beginning, or
-	when they do need the MIDI data to be adjusted for tempo map changes.
-	Tweaking tempo in a tempo marker in this mode also changes the wall clock
-	position of subsequent tempo markers.
-</p>
-
 <h2>Anatomy of tempo markers</h2>
 
 <p>
-	When working with the tempo ruler in the Change Tempo mode, each tempo
-	marker exposes several editable properties:
+	Each tempo marker exposes several editable properties:
 </p>
 
 <ul>
@@ -81,12 +47,7 @@
 	</li>
 </ul>
 
-<p>
-	In the Map Tempo mode, tempo markers also have these properties, but except
-	for the BPM at the start value, they are not exposed in the user interface.
-</p>
-
-<h2>Working with tempo markers in the Edit Tempo mode</h2>
+<h2>Working with tempo markers on the ruler</h2>
 
 <h3>Adding Tempo Markers</h3>
 
@@ -194,7 +155,7 @@
 	properties menu and applies forward in the timeline. Alternatively, you can
 	right-click a tempo marker and select the <kbd class="menu">Ramp to Next</kbd>
 	menu item. Tempo will gradually accelerate or decelerate until the target
-	tempo is reached, resulting in a musical <em>accel.</en> or <em>ritard.</em>.
+	tempo is reached, resulting in a musical <em>accel.</em> or <em>ritard.</em>
 </p>
 
 <p>
@@ -221,48 +182,14 @@
 	music is moved).
 </p>
 
-<h2>Working with tempo markers in the Map Tempo mode</h2>
-
-<h3>Adding tempo markers</h3>
+<h2>Working with tempo markers in the Grid mode</h2>
 
 <p>
-	In the Map Tempo mode, new tempo markers are only created at bar lines. Hover
-	a bar line on the tempo ruler, this will change the mouse pointer. Then click
-	and drag to align the bar line with an onset. A new tempo marker will be
-	automatically created.
+	For documentation on editing the tempo map in the Grid mode, please see
+	the <a href="/ardours-interface/the-toolbox#grid">relevant part</a> of the
+	Toolbox chapter.
 </p>
 
-<figure>
-  <img style="width:50%;" width="50%" src="/images/map-tempo-bar-line.png"
-  alt="Ramping in Map Tempo mode">
-  <figcaption>Creating a tempo marker in Map Tempo mode</figcaption>
-</figure>
-
-<h3>Tweaking positions of markers</h3>
-
-<p>
-	To tweak the position of a tempo marker, hover the bar line where it's
-	located, then click and drag it left or right.
-</p>
-
-<h3>Ramping between tempo markers</h3>
-
-<p>
-	In some cases, tempo fluctuates gradually during the performance. To deal
-	with that, it's possible to set a tempo ramp. Create two markers, one where
-	tempo begins changing, and one where it starts changing. Then hover the
-	mouse pointer between bar lines and start dragging to the left or to the
-	right. Dragging to the left increases the tempo at the beginning and lowers
-	it towards the end. Dragging to the right increases the tempo towards the
-	end and lowers it towards the beginning.
-</p>
-
-<figure>
-  <img style="width:50%;" width="50%" src="/images/map-tempo-beat-line.png"
-  alt="Ramping in Map Tempo mode">
-  <figcaption>Ramping in Map Tempo mode</figcaption>
-</figure>
-
 <h2>Further Information</h2>
 
 <p>

include/the-loop-range.html

@@ -11,6 +11,13 @@
 </p>
 
 <ul>
+  <li>
+    By selecting a region on the timeline,
+    <kbd class="mouse">right</kbd>-clicking, then selecting
+    <kbd class="menu">&lt;Region_Name&gt; &rarrow; Loop</kbd>. This will create
+    a loop range's start and end markers matching the beginning and the end of
+    the region, then start playback of the loop range immediately.
+  </li>
 	<li>
 		By selecting a range on the timeline,
 		<kbd class="mouse">right</kbd>-clicking, then selecting
@@ -145,13 +152,6 @@
       maximized yet visible entirely within Ardour's window.
     </td>
   </tr>
-  <tr>
-    <th>Glue to Bars and Beats</th>
-    <td>
-      When this option is enabled, the marker maintains its position in bars
-      and beats even if there are changes in tempo and meter.
-    </td>
-  </tr>
   <tr>
     <th>Loudness Assistant…</th>
     <td>

include/the-region-menu.html

@@ -53,7 +53,6 @@
 		<tr><th class="sub1">Move to Original Position</th><td>Moves the region where it was initially recorded or inserted in the session</td></tr>
 		<tr><th class="sub1">Snap Position to Grid</th><td>If the Grid Mode is set to <em>Grid</em>, snaps the region to the nearest grid line</td></tr>
 		<tr><th class="sub1">&square; Lock</th><td>Locks the selected regions at their current positions in time and tracks, avoiding any movement on the timeline. The region name will be surrounded by <em>&gt;</em> and <em>&lt;</em> brackets</td></tr>
-		<tr><th class="sub1">&square; Glue to Bars and Beats</th><td>Locks the region position to relative to the musical grid, i.e. a change of tempo will move the region to keep it on the same bar/beat</td></tr>
 		<tr><th class="sub1">&square; Lock to Video</th><td>Same as above, relative to the position in the video</td></tr>
 		<tr><th class="sub1">Set Sync Position</th><td>Creates or move the Sync position, i.e. the point of the region that will be aligned or snapped to the grid, and that is (by default) the beginning of the region.</td></tr>
 		<tr><th class="sub1">Remove Sync</th><td>Removes any user defined Sync point, and resets the sync position to the beginning of the region</td></tr>

include/toolbox.html

@@ -1,6 +1,6 @@
 
 <figure>
-<img src="/images/toolbar-tools.png" alt="Editor toolbar's tools, aka toolbox">
+<img width="50%" src="/images/toolbar-tools.png" alt="Editor toolbar's tools, aka toolbox">
 <figcaption>Editor toolbar's tools, AKA toolbox.</figcaption>
 </figure>
 
@@ -96,13 +96,14 @@
 
 <table>
   <tr><th><strong>Mode</strong></th><td><strong>Keyboard Shortcut</strong></td></tr>
-  <tr><th>Grab</th><td><kbd>g</kbd></td></tr>
-  <tr><th>Range</th><td><kbd>r</kbd></td></tr>
-  <tr><th>Cut</th><td><kbd>c</kbd></td></tr>
+  <tr><th>Grab</th><td><kbd>G</kbd></td></tr>
+  <tr><th>Range</th><td><kbd>R</kbd></td></tr>
+  <tr><th>Cut</th><td><kbd>C</kbd></td></tr>
   <tr><th>Audition</th><td>None</td></tr>
-  <tr><th>Stretch</th><td><kbd>t</kbd></td></tr>
-  <tr><th>Draw</th><td><kbd>d</kbd></td></tr>
-  <tr><th>Internal Edit</th><td><kbd>e</kbd></td></tr>
+  <tr><th>Stretch</th><td><kbd>T</kbd></td></tr>
+  <tr><th>Grid</th><td><kbd>Y</kbd></td></tr>
+  <tr><th>Draw</th><td><kbd>D</kbd></td></tr>
+  <tr><th>Internal Edit</th><td><kbd>E</kbd></td></tr>
 </table>
 
 <p class="note">
@@ -172,6 +173,40 @@
   the playback speed.
 </p>
 
+<h3 id="grid">Grid Mode</h3>
+
+<p>
+  The Grid mode has been designed to easily create and edit tempo maps.
+</p>
+
+<p>
+  <kbd class="mouse">Left</kbd>-clicking on the timeline above a bar line
+  creates a new tempo marker.
+</p>
+
+<video controls>
+  <source src="/videos/grid-tool-add.mp4" width="50%" type="video/mp4">
+</video>
+
+<p>
+  <kbd class="mouse">Left</kbd>-clicking and dragging on the timeline above
+  a bar line when a tempo marker already exists in that position changes
+  the value of the current and the previous markers to accomodate for.
+</p>
+
+<video controls>
+  <source src="/videos/grid-tool-edit.mp4" width="50%" type="video/mp4">
+</video>
+
+<p>
+  <kbd class="mouse">Left</kbd>-clicking and dragging on the timeline anywhere
+  between two bar lines creates a tempo ramp.
+</p>
+
+<video controls>
+  <source src="/videos/grid-tool-create-ramp.mp4" width="50%" type="video/mp4">
+</video>
+
 <h3 id="draw">Draw Mode</h3>
 
 <p>

include/track-automation.html

@@ -68,19 +68,41 @@
 <h3>Drawing an Automation Curve Using the Mouse</h3>
 
 <p>
-  In <a href="@@toolbox"><dfn>Draw</dfn> mode</a>, <dfn>control points</dfn> can be entered in the
-  automation lane by <kbd class=mouse>left</kbd>-clicking in the lane at a
-  point where there is no existing control point.
+  In <a href="@@toolbox"><dfn>Draw</dfn> mode</a>, <dfn>control points</dfn>
+  can be entered in the automation lane in multiple ways.
 </p>
 
+<ul>
+  <li>
+    By <kbd class=mouse>left</kbd>-clicking in the lane at a point where there
+    is no existing control point. Once added, a control point can be
+    <kbd class=mouse>left</kbd>-clicked and dragged to any desired location.
+    Hovering over a control point will show its current value.
+    <strong>Warning:</strong> creating a verbose automation with many control
+    points can cause some plugins to overuse available system resources.
+  </li>
+  <li>
+    By <kbd class=mouse>left</kbd>-clicking in the lane and drawing a free line
+    from left to right.
+  </li>
+  <li>
+    By pressing <kbd>Ctrl</kbd>, then pressing <kbd class=mouse>left</kbd>
+    in the lane and moving the mouse pointer from left to right or from right
+    to left to preview a line segment, then releasing the mouse button to
+    complete the action.
+  </li>
+</ul>
+
 <p>
-  Once added, a control point can be <kbd class=mouse>left</kbd>-clicked and
-  dragged to any desired location. Hovering over a control point will show its
-  current value. To remove a control point, <kbd class=mouse>left</kbd>-click
-  it and press <kbd>Delete</kbd>, or <kbd class=mod3n></kbd><kbd
-  class=mouse>right</kbd>-click on it.
+  It's possible to combine free and straight lines in one go by pressing
+  <kbd>Ctrl</kbd> for when you need a straight line and releasing the button
+  when you're done drawing a straight line segment.
 </p>
 
+<video width="100%" controls>
+  <source src="/videos/automation-draw-free-and-straight-lines.mp4" type="video/mp4">
+</video>
+
 <h2>Controlling the Track</h2>
 
 <p>
@@ -96,16 +118,22 @@
   in <kbd class=menu>Play</kbd> mode.
 </p>
 
-<h3>Removing Automation</h3>
+<h2>Removing Automation</h2>
+
+<p>
+  To remove a control point, <kbd class=mouse>left</kbd>-click it and press
+  <kbd>Delete</kbd>, or <kbd class=mod3n></kbd>
+  <kbd class=mouse>right</kbd>-click on it.
+</p>
 
 <figure class=right>
-<img src="/images/automation-audio-r-click-menu.png">
-<figcaption class=center>The automation lane context menu.</figcaption>
+  <img src="/images/automation-audio-r-click-menu.png">
+  <figcaption class=center>The automation lane context menu.</figcaption>
 </figure>
 
 <p>
-  Clearing the automation lane is done by <kbd
-  class="mouse">right</kbd>-clicking on the lane to be cleared, and selecting
-  <kbd class="menu">Clear</kbd> from the menu that appears.
+  Clearing the entire automation lane is done by
+  <kbd class="mouse">right</kbd>-clicking on the lane to be cleared, and
+  selecting <kbd class="menu">Clear</kbd> from the menu that appears.
 </p>
 

include/transforming-midi---mathematical-operations.html

@@ -1,6 +1,6 @@
 
 <figure class="right">
-  <img src="/images/MIDI_transform.png" alt="MIDI transformation">
+  <img width="400px" src="/images/MIDI_transform.png" alt="MIDI transformation">
   <figcaption>The MIDI transformation dialog</figcaption>
 </figure>
 

include/transposing-midi.html

@@ -1,6 +1,6 @@
 
 <figure>
-  <img src="/images/transpose_midi.png" alt="The Transpose dialog">
+  <img width="50%" src="/images/transpose_midi.png" alt="The Transpose dialog">
   <figcaption>
     The Transpose dialog
   </figcaption>

master-doc.txt

@@ -573,6 +573,14 @@ uri: working-with-markers/cue-markers
 part: subchapter
 ---
 
+---
+title: Arrangement
+include: arrangement-ruler.html
+link: arrangement-ruler
+uri: working-with-markers/arrangement-ruler.html
+part: subchapter
+---
+
 ---
 title: Summary
 include: summary.html
@@ -589,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
@@ -598,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
 ---
 
@@ -1456,6 +1472,14 @@ uri: editing-and-arranging/editing-midi/changing-note-properties
 part: subchapter
 ---
 
+---
+title: Editing Velocity
+include: midi-velocity-editing.html
+link: editing-velocity
+uri: editing-and-arranging/editing-midi/editing-velocity
+part: subchapter
+---
+
 ---
 title: Patch Change
 include: patch-change.html