Update section on inverting the polarity of a track.

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

3 files changed, 38 insertions, 11 deletions

diff --git a/manual/images/invert_polarity.png b/manual/images/invert_polarity.png
new file mode 100644
index 0000000000..a8f43f42bb
--- /dev/null
+++ b/manual/images/invert_polarity.png
diff --git a/manual/xml/invert_polarity.xml b/manual/xml/invert_polarity.xml
new file mode 100644
index 0000000000..fa844ce14a
--- /dev/null
+++ b/manual/xml/invert_polarity.xml
@@ -0,0 +1,36 @@
+<?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-invert-polarity">
+  <title>Inverting the Polarity of a Track</title>
+  <para>
+    The polarity of a track can be inverted in the Mixer Window by clicking
+    on the track name button of a Mixer Strip and choosing
+    <menuchoice><guimenu>Invert Polarity</guimenu></menuchoice>.
+  </para>
+  <mediaobject>
+    <imageobject>
+      <imagedata fileref="images/invert_polarity.png"/>
+    </imageobject>
+  </mediaobject>
+  <para>
+    When the polarity of a track is inverted a <literal>Ø</literal> will
+    appear before the track name in the Mixer Strip.
+  </para>
+
+  <para>
+    This could be used to correct the polarity of an input signal due to
+    incorrect wiring or to prevent two signals that are out of phase with
+    respect to each other resulting in cancellation when mixing.
+  </para>
+<!--
+	<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" 
+		href="Some_Subsection.xml" />
+	-->
+</section>
diff --git a/manual/xml/mixer_strips.xml b/manual/xml/mixer_strips.xml
index b381ced49a..a9028bad48 100644
--- a/manual/xml/mixer_strips.xml
+++ b/manual/xml/mixer_strips.xml
@@ -109,17 +109,8 @@
       leaving the number of ports untouched.
     </para>
   </section>
-
-  <section id="mixer-strip-polarity-button">
-    <title>Polarity Button</title>
-    <para>
-      The polarity button, when pressed, inverts the phase of the signal as
-      it leaves the track and enters the mixer strip. it has no effect on
-      the signal being recorded to disk. It has no effect on the timing of
-      the signal, either.
-    </para>
-  </section>
-
+  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" 
+	  href="invert_polarity.xml" />
   <section id="mixer-strip-solo-button">
     <title>Solo Button</title>
     <para>