Move section on soloing tracks to separate file

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

2 files changed, 130 insertions, 115 deletions

diff --git a/manual/xml/soloing_tracks.xml b/manual/xml/soloing_tracks.xml
new file mode 100644
index 0000000000..b0d34c9e43
--- /dev/null
+++ b/manual/xml/soloing_tracks.xml
@@ -0,0 +1,128 @@
+<?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-soloing-tracks">
+  <title>Soloing Tracks</title>
+  <indexterm>
+    <primary>Tracks</primary>
+    <secondary>Soloing</secondary>
+  </indexterm>
+  <para>
+    "Soloing" a track refers to changing some aspect of the signal flow
+    through Ardour that makes it possible to listen to one (or just a few)
+    tracks at a time. It is often done during mixing and mastering to help
+    an audio engineer listen carefully to parts of the mix.
+  </para>
+
+  <para>
+    Tracks may be soloed at any time. When one or more tracks are soloed,
+    all non-soloedntracks will no longer be audible.
+  </para>
+
+  <para>
+    Soloing tracks does not affect the solo status of busses, nor vice
+    versa. That is, soloing a track leaves all busses audible and soloing a
+    track leaves all tracks "audible". You may not actually be able to hear
+    the "audible" material if it is routed through a non-soloed bus.
+  </para>
+
+  <para>
+    This design is intended to allow FX busses and master outs to be useful
+    even when soloing. Soloing is made significantly more complex by the
+    presence of control outs (see control_outs_soloing for more details on
+    soloing with control outs).
+  </para>
+
+  <section id="rude-solo-light">
+    <title>Rude Solo Light</title>
+    <para>
+      Whenever one or more tracks are soloed, the "rude solo light" in the
+      transport window will flash. You can cancel any current solos by
+      clicking on the "rude solo light".
+    </para>
+  </section>
+
+  <section id="solo-modes">
+    <title>Solo modes</title>
+    <para>
+      Ardour has two solo modes.
+    </para>
+
+    <variablelist>
+      <title></title>
+      <varlistentry>
+        <term>solo latch</term>
+        <listitem>
+          <para>
+            soloing a track adds it to the set of soloed tracks, so you may
+            have any number of soloed tracks.
+          </para>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry>
+        <term>solo unlatch</term>
+        <listitem>
+          <para>
+            soloing a track unsolos any other soloed track, so you can have
+            only one soloed track at a time.
+          </para>
+        </listitem>
+      </varlistentry>
+    </variablelist>
+  </section>
+
+  <section id="changing-solo-mode">
+    <title>Changing Solo Mode</title>
+    <para>
+      To change the solo mode, goto the Options editor (options_editor) and
+      view the <guilabel>Misc</guilabel> tab.
+    </para>
+  </section>
+
+  <section id="soloing-a-track">
+    <title>Soloing a Track</title>
+    <para>
+      To toggle the solo state of a track, click on the solo button in
+      either the mixer strip for the track or the track controls section in
+      the editor.
+    </para>
+
+    <para>
+      To toggle the solo state of all tracks in an edit or mix group, use
+      Ctrl1 on the solo button of a track in the group. If you do this in
+      the Editor, the edit group will be used; in the Mixer, the mix group
+      will be used.
+    </para>
+
+    <para>
+      To toggle the solo state of all tracks, use
+      <keycombo><keycap>Ctrl</keycap><keycap>Shift</keycap><mousebutton>Button1</mousebutton></keycombo>
+      on a track solo button.
+    </para>
+  </section>
+
+  <section id="solo-safe">
+    <title>Solo safe</title>
+    <para>
+      To protect a track's current solo status, use Shift1 on that track's
+      solo button. The color of the button will change to a pale blue to
+      indicate "solo safe" status. No changes to the solo state for that
+      track are possible until "solo safe" has been unset for the track.
+    </para>
+  </section>
+
+  <section id="momentary-solo">
+    <title>Momentary solo</title>
+    <para>
+      Use 2 on a track's solo button to solo the track for as long as the
+      mouse button is pressed.
+    </para>
+  </section>
+</section>
diff --git a/manual/xml/tracks_and_busses.xml b/manual/xml/tracks_and_busses.xml
index 4e1ac6adb5..65992a8764 100644
--- a/manual/xml/tracks_and_busses.xml
+++ b/manual/xml/tracks_and_busses.xml
@@ -96,121 +96,8 @@
     <para></para>
   </section>
 
-  <section id="soloing-tracks">
-    <title>Soloing Tracks</title>
-    <para>
-      "Soloing" a track refers to changing some aspect of the signal flow
-      through Ardour that makes it possible to listen to one (or just a few)
-      tracks at a time. It is often done during mixing and mastering to help
-      an audio engineer listen carefully to parts of the mix.
-    </para>
-
-    <para>
-      Tracks may be soloed at any time. When one or more tracks are soloed,
-      all non-soloedntracks will no longer be audible.
-    </para>
-
-    <para>
-      Soloing tracks does not affect the solo status of busses, nor vice
-      versa. That is, soloing a track leaves all busses audible and soloing
-      a track leaves all tracks "audible". You may not actually be able to
-      hear the "audible" material if it is routed through a non-soloed bus.
-    </para>
-
-    <para>
-      This design is intended to allow FX busses and master outs to be
-      useful even when soloing. Soloing is made significantly more complex
-      by the presence of control outs (see control_outs_soloing for more
-      details on soloing with control outs).
-    </para>
-
-    <section id="rude-solo-light">
-      <title>Rude Solo Light</title>
-      <para>
-        Whenever one or more tracks are soloed, the "rude solo light" in the
-        transport window will flash. You can cancel any current solos by
-        clicking on the "rude solo light".
-      </para>
-    </section>
-
-    <section id="solo-modes">
-      <title>Solo modes</title>
-      <para>
-        Ardour has two solo modes.
-      </para>
-
-      <variablelist>
-        <title></title>
-        <varlistentry>
-          <term>solo latch</term>
-          <listitem>
-            <para>
-              soloing a track adds it to the set of soloed tracks, so you
-              may have any number of soloed tracks.
-            </para>
-          </listitem>
-        </varlistentry>
-
-        <varlistentry>
-          <term>solo unlatch</term>
-          <listitem>
-            <para>
-              soloing a track unsolos any other soloed track, so you can
-              have only one soloed track at a time.
-            </para>
-          </listitem>
-        </varlistentry>
-      </variablelist>
-    </section>
-
-    <section id="changing-solo-mode">
-      <title>Changing Solo Mode</title>
-      <para>
-        To change the solo mode, goto the Options editor (options_editor)
-        and view the <guilabel>Misc</guilabel> tab.
-      </para>
-    </section>
-
-    <section id="soloing-a-track">
-      <title>Soloing a Track</title>
-      <para>
-        To toggle the solo state of a track, click on the solo button in
-        either the mixer strip for the track or the track controls section
-        in the editor.
-      </para>
-
-      <para>
-        To toggle the solo state of all tracks in an edit or mix group, use
-        Ctrl1 on the solo button of a track in the group. If you do this in
-        the Editor, the edit group will be used; in the Mixer, the mix group
-        will be used.
-      </para>
-
-      <para>
-        To toggle the solo state of all tracks, use
-        <keycombo><keycap>Ctrl</keycap><keycap>Shift</keycap><mousebutton>Button1</mousebutton></keycombo>
-        on a track solo button.
-      </para>
-    </section>
-
-    <section id="solo-safe">
-      <title>Solo safe</title>
-      <para>
-        To protect a track's current solo status, use Shift1 on that track's
-        solo button. The color of the button will change to a pale blue to
-        indicate "solo safe" status. No changes to the solo state for that
-        track are possible until "solo safe" has been unset for the track.
-      </para>
-    </section>
-
-    <section id="momentary-solo">
-      <title>Momentary solo</title>
-      <para>
-        Use 2 on a track's solo button to solo the track for as long as the
-        mouse button is pressed.
-      </para>
-    </section>
-  </section>
+  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" 
+		href="soloing_tracks.xml" />
 
   <section id="track-display-size">
     <title>Track Display Size</title>