Update Luadoc for upcoming Ardour 7

[ardour-manual] / include / automation.html

diff --git a/include/automation.html b/include/automation.html
index 3342b90415d7f737e3d8937c1131364f7c1f509d..cb39e6789f3c4b0020c7060d47dfdd087f8c6ccc 100644 (file)
--- a/include/automation.html
+++ b/include/automation.html
@@ -1,7 +1,48 @@
----
-title: Automation
----
 
-<p class="fixme">Add content</p>
+<figure class="center">
+<img src="/images/automation-lane1.png">
+<figcaption class="center">A typical automation lane.</figcaption>
+</figure>
+
+<p>
+  <dfn>Automation</dfn> is the ability to dynamically control various aspects
+  of a track's innate attributes and the attributes of any processors attached
+  to it. In Ardour, automation can be used to make dynamic changes to a
+  track's:
+</p>
+
+<figure class="right">
+  <img src="/images/automation-menu1.png">
+  <figcaption class=center>The automation menu.</figcaption>
+</figure>
+
+<ul>
+  <li>Fader (Volume)</li>
+  <li>Trim</li>
+  <li>Muting</li>
+  <li>Panning</li>
+  <li>Any attached processor's parameters</li>
+</ul>
+
+<p>
+  Any combination of these can be enabled on a single track; as such, it offers
+  a lot of power and flexibility over how a track will ultimately sound when
+  played back.
+</p>
+
+<p>
+  Activating automation for a track is done by clicking the <kbd class="menu">A</kbd> icon on the
+  <a href="@@audio-track-controls">track head</a> and checking the
+  type of automation needed. A new "pseudo-track" will appear, showing the 
+  waveform in the background, called an "automation lane", where the value
+  of the parameter can be edited : the x axis is the time, and the y axis is
+  the value of the parameter.
+</p>
+<p>
+  If the <kbd class="option">Edit &gt; Show Automation Lane on Touch</kbd>
+  is checked, clicking any parameter in a plugin window, a hardware controller, etc...
+  will result in this parameter's automation lane being temporarily shown, 
+  and clicking another parameter will hide this lane to show the new one.
+</p>