Add initial bbt markers documentation

diff --git a/include/bbt-markers.html b/include/bbt-markers.html
new file mode 100644 (file)
index 0000000..1340010
--- /dev/null
+++ b/include/bbt-markers.html
@@ -0,0 +1,28 @@
+<p>
+  <dfn>BBT markers</dfn> allow resetting the timeline to a particular bar and
+  beat. Most of the time a BBT marker will reset it to 1|1|0 (the very first
+  beat of the very first bar) so that for each song in a multi-song session
+  there would be a musical time origin. However it's entirely possible to reset
+  to an arbitrary value such as 7|3|0.
+</p>
+
+<p>
+  To create a new BBT marker, <kbd class="mod1n"></kbd>-click on the
+  Bars:Beats ruler. This will open a dialog titled 'New Music Time' where you
+  can name the marker and define what bar (left field) and beat (right field)
+  this marker should reset the time to.
+</p>
+
+<figure>
+  <img style="width:50%;" width="50%" src="/images/new-music-time.png" alt="New Music Time dialog">
+  <figcaption>New Music Time dialog</figcaption>
+</figure>
+
+<p>
+  The timeline grid and the ruler will be updated accordingly:
+</p>
+
+<figure>
+  <img style="width:50%;" width="50%" src="/images/bbt-marker-resets-musical-time.png" alt="The BBT marker resets the musical time">
+  <figcaption>The BBT marker resets the musical time</figcaption>
+</figure>

diff --git a/master-doc.txt b/master-doc.txt
index ee936530c52c1612b3dc99799f51c4ad130896d7..e7e22cd406299cbaf6dfd0345216e6041e8e523c 100644 (file)
--- a/master-doc.txt
+++ b/master-doc.txt
@@ -1652,6 +1652,12 @@ link: techniques-for-working-with-tempo-and-meter
 part: subchapter
 ---
 
+---
+title: BBT markers
+include: bbt-markers.html
+link: bbt-markers
+part: subchapter
+---
 
 ---
 title: Mixing

diff --git a/source/images/bbt-marker-resets-musical-time.png b/source/images/bbt-marker-resets-musical-time.png
new file mode 100644 (file)
index 0000000..03a02ba
Binary files /dev/null and b/source/images/bbt-marker-resets-musical-time.png differ

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