Documenting Track > Insert time/Remove Time

diff --git a/include/insert-remove-time.html b/include/insert-remove-time.html
new file mode 100644 (file)
index 0000000..cc35a0f
--- /dev/null
+++ b/include/insert-remove-time.html
@@ -0,0 +1,81 @@
+
+<h2>Insert Time</h2>
+
+<figure>
+  <img src="/images/insert-time.png" alt="The Insert Time window">
+  <figcaption>
+    The Insert Time window
+  </figcaption>
+</figure>
+
+<p>
+  The <dfn>Insert Time</dfn> window allows to insert blank space in the timeline,
+  on the selected track(s). It is accessed through the <kbd class="menu">Track
+   &gt; Insert Time</kbd> menu.
+</p>
+<p>
+  The Insert Time window not only allows to set the time inserted, but also some fine tuning options:
+</p>
+
+<dl>
+  <dt>Insert Time starting at:</dt>
+    <dd>Sets the point in the session where the time will be added. By default, it is the playhead's position</dd>
+  <dt>Time to insert:</dt>
+    <dd>Duration of the blank space inserted</dd>
+  <dt>Inserted regions should:</dt>
+    <dd>A choice as to what happens to regions that exists at the Insert Time set above. See below.</dd>
+  <dt>Apply to all the track's playlists</dt>
+    <dd>As a track can have multiple <a href="@@understanding-playlists">playlists</a>, the insertion can happen either only on the active playlist or on all the plylists of this track</dd>
+  <dt>Move glued-to-musical-time regions (MIDI regions)</dt>
+    <dd>Defines if MIDI regions in selected tracks are affected by the operation</dd>
+  <dt>Move markers</dt>
+    <dd>As a <a href="@@working-with-markers">marker</a> can be <kbd class="option">locked</kbd> or <kbd class="option">glued to bars/beats</kbd>, this option and the two subjascent ones allow to shift the time position of those markers</dd>
+  <dt>Move tempo and meter changes</dt>
+    <dd>The <a href="@@tempo-and-meter">tempo and meter</a> markers, that can be used to change the tempo along the session, can also be shifted in the process. Though, moving the tempo markers while e.g. keeping the MIDI regions unaffected can create oddities.</dd>
+</dl>
+
+<p>
+  Both the two time fields have a useful context menu, that allows to copy/paste
+  the time and change the display among one of the <a href="@@editing-clocks">clock
+  modes</a>. The Insert Time field also has two options to <kbd class="menu">Set
+  from Playhead</kbd> (to get the insertion time from the playhead, which is what
+  happens by default) and <kbd class="menu">Locate to This Time</kbd> which moves
+  the playhead to the time field value, useful if the field has been manually edited
+  to better visualize the insertion point.
+</p>
+
+<p>
+  By default, inserting time only results in shifting positions of the regions
+  beginning <em>after</em> the insertion point. The "Inserted regions should" dropdown
+  menu allows to choose what happens to the regions that exist at the insertion time :
+</p>
+
+<dl>
+  <dt><dfn>stay in position</dfn> <em>(default)</em></dt><dd>The crossed regions are not affected by the time insertion</dd>
+  <dt><dfn>move</dfn></dt><dd>The crossed regions are shifted in time</dd>
+  <dt><dfn>be split</dfn></dt><dd>The crossed regions are split, and the section that is after the time insertion point are shifted in time</dd>
+</dl>
+
+<p>
+  This last mode allows a <em>brute force</em> insertion, creating a blank space
+  in all the selected tracks, and replacing multiple operations.
+</p>
+
+<p class="note">
+  Note: One interesting option is, if a range selection (created with in <a href="@@toolbox">
+  Range Mode</a>) exists, it is used as the default parameters in the window, instead
+  of the playhead, for both the start time and duration.
+</p>
+
+
+<h2>Remove Time</h2>
+
+<p>
+  The <dfn>Remove Time</dfn> window, accessed through the <kbd class="menu">Track
+   &gt; Remove Time</kbd> menu, is very similar to the previous, and its options
+   are very similar. Only the <em>"Inserted regions should"</em> option is not present
+</p>
+
+<p>
+  The range selection note above can be especially useful in this context.
+</p>

diff --git a/include/tempo-and-meter.html b/include/tempo-and-meter.html
index 55446165e4b3a81f2e0e3859c4492abe2e79af01..3f400d57c4118708044a0514d05bb531c49aac89 100644 (file)
--- a/include/tempo-and-meter.html
+++ b/include/tempo-and-meter.html
@@ -38,7 +38,7 @@
 </p>
 
 <p>
-  A tempo may be remped or constant.
+  A tempo may be ramped or constant.
 </p>
 
 <ul>

diff --git a/master-doc.txt b/master-doc.txt
index 87cc0bf6a4d7ba8bace68a54ec27db8121781413..ecd4b3166d8f09a6f6da888a1a71fbfe6357f460 100644 (file)
--- a/master-doc.txt
+++ b/master-doc.txt
@@ -1431,6 +1431,13 @@ uri: editing-and-arranging/strip-silence-from-audio-regions
 part: subchapter
 ---
 
+---
+title: Insert/Remove Time
+include: insert-remove-time.html
+link: insert-remove-time
+part: subchapter
+---
+
 ---
 title: Fades and Crossfades
 include: create-region-fades-and-crossfades.html

diff --git a/source/images/insert-time.png b/source/images/insert-time.png
new file mode 100644 (file)
index 0000000..45a92b9
Binary files /dev/null and b/source/images/insert-time.png differ