Add a section on deactivating tracks

git-svn-id: svn://localhost/ardour2/trunk@1905 d708f5d6-7413-0410-9779-e7cbd77b26cf

3 files changed, 45 insertions, 0 deletions

diff --git a/manual/images/inactive_track.png b/manual/images/inactive_track.png
new file mode 100644
index 0000000000..79cb8ab592
--- /dev/null
+++ b/manual/images/inactive_track.png
diff --git a/manual/xml/deactivating_tracks.xml b/manual/xml/deactivating_tracks.xml
new file mode 100644
index 0000000000..a625467cee
--- /dev/null
+++ b/manual/xml/deactivating_tracks.xml
@@ -0,0 +1,43 @@
+<?xml version="1.0" standalone="no"?>
+
+<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
+
+<!ENTITY % BOOK_ENTITIES SYSTEM "./entities.ent">
+%BOOK_ENTITIES;
+
+]>
+
+<section id="sn-deactivating-tracks">
+  <title>Deactivating Tracks</title>
+  <indexterm>
+    <primary>Tracks</primary>
+    <secondary>Deactivating</secondary>
+  </indexterm>
+  <para>
+    A track can be deactivated from the track context menu which is accessed
+    by clicking on the empty space in the &TRACK_CONTROLS; and choosing the
+    <guimenuitem>Active</guimenuitem> menu item. A track can also be made
+    inactive from the track name button in a &MIXER_STRIP;.
+  </para>
+  <mediaobject>
+    <imageobject>
+      <imagedata fileref="images/inactive_track.png"/>
+    </imageobject>
+    <caption>
+      <para>
+        The &TRACK_CONTROLS; and &MIXER_STRIP; of inactive tracks have a
+        different background color to differenciate them from active tracks.
+      </para>
+    </caption>
+  </mediaobject>
+  <para>
+    Deactivating a track will silence it and reduce the amount of system
+    resources required to operate the session. An inactive Audio Track will
+    not read audio data from disk, unlike when a track is
+    <link linkend="sn-muting-tracks">muted</link>.
+  </para>
+<!--
+	<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" 
+		href="Some_Subsection.xml" />
+	-->
+</section>
diff --git a/manual/xml/tracks_and_busses.xml b/manual/xml/tracks_and_busses.xml
index f6cb0d4f5f..9b539920ec 100644
--- a/manual/xml/tracks_and_busses.xml
+++ b/manual/xml/tracks_and_busses.xml
@@ -96,6 +96,8 @@
 		href="muting_tracks.xml" />
   <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" 
 		href="soloing_tracks.xml" />
+  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" 
+		href="deactivating_tracks.xml" />
   <section id="track-display-size">
     <title>Track Display Size</title>
     <para>