Continued GUI rework, further gnomeification of documentation - Alex
authorterminatorX <>
Sun, 24 Nov 2002 00:31:56 +0000 (00:31 +0000)
committerterminatorX <>
Sun, 24 Nov 2002 00:31:56 +0000 (00:31 +0000)
terminatorX/doc/terminatorX-manual/C/figures/signalflow.dia
terminatorX/doc/terminatorX-manual/C/figures/signalflow.png
terminatorX/doc/terminatorX-manual/C/terminatorX-manual.xml
terminatorX/src/tX_extdial.cc
terminatorX/src/tX_extdial.h
terminatorX/src/tX_mastergui.cc

index 0f34e3f7f77b918609853e357f584ee780d693a6..adcce6a249f292c972f870fcc46e02661444471f 100644 (file)
Binary files a/terminatorX/doc/terminatorX-manual/C/figures/signalflow.dia and b/terminatorX/doc/terminatorX-manual/C/figures/signalflow.dia differ
index 5ec69e30f689875f5c3769e469b59669109c5e7d..4f75420da3e9241d46a5a42866dab2fb9ac68f87 100644 (file)
Binary files a/terminatorX/doc/terminatorX-manual/C/figures/signalflow.png and b/terminatorX/doc/terminatorX-manual/C/figures/signalflow.png differ
index 3444648d0dc2e94d12835e2da1c59ef05e13d499..937b92dc00b9b81f816cf93657befba7dac3587e 100644 (file)
-<?xml version="1.0"?>
+<?xml version='1.0' encoding='UTF-8'?>
 <!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
 "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [
-  <!ENTITY legal SYSTEM "legal.xml">
-  <!ENTITY GFDL SYSTEM "fdl-appendix.xml">
-  <!ENTITY appversion "0.3.5">
-  <!ENTITY manrevision "0.1.1">
-  <!ENTITY date "March 18, 2002">
-  <!-- Information about the entities
-       The legal.xml file contains legal information, there is no need to edit the file.
-       Use the appversion entity to specify the version of the application.
-       Use the manrevision entity to specify the revision number of this manual.
-       Use the date entity to specify the release date of this manual.
-       Use the app entity to specify the name of the application. -->
+<!ENTITY legal SYSTEM "legal.xml">
+<!ENTITY GFDL SYSTEM "fdl-appendix.xml">
+<!ENTITY appversion "3.74">
+<!ENTITY manrevision "1.0">
+<!ENTITY date "November 22, 2002">
 ]>
 <article id="index" lang="en">
   <articleinfo>
     <title>terminatorX - Manual</title>
-    <author><firstname>Alexander</firstname>
-      <surname>K&ouml;nig</surname></author>
-    <copyright><year>1999 - 2002</year>
-      <holder ROLE="mailto:alex@rhlx01.fht-esslingen.de">Alexander K&ouml;nig</holder></copyright>
-    <releaseinfo>Version 3.73</releaseinfo></articleinfo>
-  <preface id="preface">
-    <title>Preface</title>
-    <para>This is free software see the
-      <filename moreinfo="NONE">COPYING</filename>
-      file that came with this distribution for details.</para>
-    <para><emphasis>Warning:</emphasis> TerminatorX comes with
-      <emphasis>ABSOLUTELY NO WARRANTY</emphasis>. This software is
-      known o lockup X11 or cause other problems under rare conditions. Don't
-      use it on production servers. You have been
-      warned!</para></preface>
-
-  <section id="INTRODUCTION"><title>Introduction</title>
-    <section id="WHATITIS"><title>What it is</title>
-      <para><application moreinfo="NONE">terminatorX</application> is a
-       realtime audio synthesizer that allows you to "scratch" on
-       digitally sampled audio data (*.wav, *.au, *.mp3, *.ogg etc.)
-       the way hiphop-DJs scratch on vinyl records. It features
-       multiple turntables, realtime effects (built-in as well as
-       LADSPA plugin effects), a sequencer and an easy-to-use gtk+
-       GUI.</para>
-
-      <para>This is <emphasis>beta</emphasis> Software please help me
-       fix bugs. See <xref linkend="CONTACT"/>
-       (Contact/Download). Please read this manual and take a look at
-       the
-       <ulink url="http://www.terminatorX.cx">homepage</ulink>.
-      </para></section>
-
-    <section id="QUICKSTART"><title>Quickstart</title>
-      <orderedlist CONTINUATION="RESTARTS"
-                  INHERITNUM="IGNORE"><listitem><para>If you don't have
-           <application moreinfo="NONE">LADSPA</application> (Linux
-           Audio Developer's Simple Plugin API) installed, go and get
-           it from the 
-           <ulink url="http://www.ladspa.org">LADSPA-homepage</ulink>
-           and install the SDK. terminatorX requires 
-           <filename moreinfo="NONE">ladspa.h</filename>.</para></listitem>
-       <listitem><para>Install terminatorX (see 
-           <filename moreinfo="NONE">INSTALL</filename>)</para></listitem>
-       <listitem><para>Run terminatorX</para></listitem>
-       <listitem><para>Load an audiofile into the available turntable
-           (you can add more turntables if you want) (Hint: Click on
-           the button that holds "NONE" to load an audiofile, or drop
-           one over the audiofile display from your filemanager if your
-           filemanager is efm, gmc, Nautilus or compatible (kfm does
-           <emphasis>not</emphasis> work))</para></listitem>
-       <listitem>
-         <para>Load a LADSPA plugin of your choice by clicking the
-           turntable's <emphasis>FX</emphasis> button and enable it.
-         </para>
-       </listitem>
-
-       <listitem><para>Click on the "Audio Engine"-button to start
-           playback.</para></listitem>
-
-       <listitem><para>Click on the "Mouse-Grab"-button to enter grab
-           mode. The turntable with the red border has the input
-           focus.</para></listitem>
-
-       <listitem><para>Press <keycap moreinfo="NONE">SPACE</keycap> or
-           left mouse button to scratch.</para></listitem>
-
-       <listitem><para>Release <keycap moreinfo="NONE">SPACE</keycap>  or left mouse button to let the scratch-file run at the turntable's default speed.</para></listitem>
-       <listitem><para>Press <keycap moreinfo="NONE">ESCAPE</keycap> to
-           quit grab mode.</para></listitem></orderedlist></section>
-
-    <section id="FEATURES"><title>Features</title>
-      <itemizedlist><listitem><para>Scratching ;)</para></listitem>
-       <listitem><para>Multiple turntables</para></listitem>
-       <listitem><para>Built-in Sequencer</para></listitem>
-       <listitem><para>Pitch / Volume settings for each turntable</para></listitem>
-       <listitem><para>Effects (Lowpass/Echo) configurable for each turntable</para></listitem>
-       <listitem><para>Syncing tables to one master turntable</para></listitem>
-       <listitem><para>Broad audiofile-type support through the use of sox and mpg123</para></listitem>
-       <listitem><para>Recording (straight to disk now)</para></listitem>
-       <listitem><para>Save turntable sets (.tX - files)</para></listitem>
-       <listitem><para>Support for the LADSPA-plugin-standard.</para></listitem>
-       <listitem><para>and more</para></listitem></itemizedlist></section>
-    <section id="REQUIREMENTS"><title>Requirements</title>
-      <itemizedlist><listitem><para>Software</para>
-         <itemizedlist><listitem><para>required</para>
-             <itemizedlist><listitem><para>The Linux Operating System (Version &gt;=
-                   2.0) or FreeBSD</para></listitem>
-               <listitem><para>glibc2 (pthreads).</para></listitem>
-               <listitem><para>XFree86 (with DGA DirectMouse
-                   support). Note that XFree86 Release 4.0 has a bug
-                   resulting in broken DirectMouse support. This has
-                   been fixed by the XFree86-Team with Release 4.0.1
-                   available from your distribution or the 
-                   <ulink url="http://www.xfree86.org">XFree86
-                     homepage</ulink>.
-                 </para></listitem>
-               <listitem><para>The Gimp Toolkit: gtk+ (>= 1.2.5) - Version 2 of gtk+ is
-                   supported, too. If your distribution doesn't provide
-                   a current version of gtk+ get it from the 
-                   <ulink url="http://www.gtk.org">gtk+
-                     homepage</ulink>.
-                 </para></listitem>
-               <listitem><para>LADSPA - the Linux Audio Developer's
-                   Simple Plugin API. Get it from the
-                   <ulink url="http://www.ladpsa.org">LADSPA homepage</ulink>
-                 </para></listitem>
-               <listitem><para>a compiler
-                   (gcc)</para></listitem></itemizedlist></listitem>
-           <listitem><para>optional</para>
-             <itemizedlist><listitem><para>
-                   <ulink url="http://home.sprynet.com/~cbagwell/sox.html">sox</ulink>
-                   for enhanced audio file support</para></listitem>
-               <listitem><para>
-                   <ulink url="http://www-ti.informatik.uni-tuebingen.de/~hippm/mpg123.html">mpg123</ulink>
-                   for mp3 support</para></listitem>
-               <listitem><para>
-                   <ulink url="http://www.xiph.org/ogg/vorbis/">ogg123</ulink>
-                   for Ogg Vorbis support</para></listitem>
-
-             </itemizedlist></listitem></itemizedlist></listitem>
-       <listitem><para>Hardware</para>
-         <itemizedlist><listitem><para>An OSS compatible soundcard
-               capable of stereo output. This includes
-               <emphasis>all</emphasis> 
-               <ulink url="http://www.alsa-project.org">ALSA-driven</ulink> 
-               soundcards as this enhanced audio device interface includes support for
-               the OSS API.</para></listitem>
-
-           <listitem><para>A good clean mouse and pad, a good X-Pointer
-               setup.</para></listitem></itemizedlist></listitem></itemizedlist>
-
-      <para>A note on performance: terminatorX is known to run
-       satisfyingly on pentium-class systems (or above of
-       course). Increasing the number of turntables or plugins will of
-       course require more performant systems.</para></section>
-
-    <section id="INSTALLATION"><title>Installation</title>
-      <para>For GNU-standards' sake this information is now located in
-       the <filename moreinfo="NONE">INSTALL</filename> file that came
-       with this distribution of
-       terminatorX.</para></section></section>
-
-  <section id="OPERATION"><title>Operation</title>
+
+    <author>
+      <firstname>Alexander</firstname>
+
+      <surname>König</surname>
+    </author>
+
+    <copyright>
+      <year>1999</year>
+      <year>2000</year>
+      <year>2001</year>
+      <year>2002</year>
+
+      <holder role="mailto:alex@lisas.de">Alexander König</holder>
+    </copyright>
+
+    <releaseinfo>Version 3.73</releaseinfo>
+    
+    &legal;
+  </articleinfo>
+
+  <sect1 id="INTRODUCTION">
+    <title>Introduction</title>
+
+    <sect2 id="WHATITIS">
+      <title>What it is</title>
+
+      <para><application moreinfo="none">terminatorX</application> is a
+      realtime audio synthesizer that allows you to &#34;scratch&#34; on
+      digitally sampled audio data (*.wav, *.au, *.mp3, *.ogg etc.) the way
+      hiphop-DJs scratch on vinyl records. It features multiple turntables,
+      realtime effects (built-in as well as LADSPA plugin effects), a
+      sequencer and an easy-to-use gtk+ GUI.</para>
+
+      <para>This is <emphasis>beta</emphasis> Software please help me fix
+      bugs. See <xref linkend="CONTACT" /> (Contact/Download). Please read
+      this manual and take a look at the <ulink
+      url="http://www.terminatorX.cx">homepage</ulink>.</para>
+    </sect2>
+
+    <sect2 id="QUICKSTART">
+      <title>Quickstart</title>
+
+      <para>Try the following steps:</para>
+      <orderedlist inheritnum="ignore" continuation="restarts">
+        <listitem>
+          <para>If you don&#39;t have <application moreinfo="none">LADSPA</application>
+          (Linux Audio Developer&#39;s Simple Plugin API) installed, go and
+          get it from the <ulink url="http://www.ladspa.org">LADSPA-homepage</ulink>
+          and install the SDK. terminatorX requires <filename moreinfo="none">ladspa.h</filename>.</para>
+        </listitem>
+
+        <listitem>
+          <para>Install terminatorX (see <filename moreinfo="none">INSTALL</filename>)</para>
+        </listitem>
+
+        <listitem>
+          <para>Run terminatorX</para>
+        </listitem>
+
+        <listitem>
+          <para>Load an audiofile into the available turntable (you can add
+          more turntables if you want) (Hint: Click on the button that holds
+          &#34;NONE&#34; to load an audiofile, or drop one over the audiofile
+          display from your filemanager if your filemanager is efm, gmc,
+          Nautilus or compatible (kfm does <emphasis>not</emphasis> work))</para>
+        </listitem>
+
+        <listitem>
+          <para>Load a LADSPA plugin of your choice by clicking the
+          turntable&#39;s <emphasis>FX</emphasis> button and enable it.</para>
+        </listitem>
+
+        <listitem>
+          <para>Click on the &#34;Audio Engine&#34;-button to start playback.</para>
+        </listitem>
+
+        <listitem>
+          <para>Click on the &#34;Mouse-Grab&#34;-button to enter grab mode.
+          The turntable with the red border has the input focus.</para>
+        </listitem>
+
+        <listitem>
+          <para>Press <keycap moreinfo="none">SPACE</keycap> or left mouse
+          button to scratch.</para>
+        </listitem>
+
+        <listitem>
+          <para>Release <keycap moreinfo="none">SPACE</keycap> or left mouse
+          button to let the scratch-file run at the turntable&#39;s default
+          speed.</para>
+        </listitem>
+
+        <listitem>
+          <para>Press <keycap moreinfo="none">ESCAPE</keycap> to quit grab
+          mode.</para>
+        </listitem>
+      </orderedlist>
+    </sect2>
+
+    <sect2 id="FEATURES">
+      <title>Features</title>
+      <para>The following list summarizes terminatorX' main features:</para>
+
+      <itemizedlist>
+        <listitem>
+          <para>Scratching ;)</para>
+        </listitem>
+
+        <listitem>
+          <para>Multiple turntables</para>
+        </listitem>
+
+        <listitem>
+          <para>Built-in Sequencer</para>
+        </listitem>
+
+        <listitem>
+          <para>Pitch / Volume settings for each turntable</para>
+        </listitem>
+
+        <listitem>
+          <para>Effects (Lowpass/Echo) configurable for each turntable</para>
+        </listitem>
+
+        <listitem>
+          <para>Syncing tables to one master turntable</para>
+        </listitem>
+
+        <listitem>
+          <para>Broad audiofile-type support through the use of sox and mpg123</para>
+        </listitem>
+
+        <listitem>
+          <para>Recording (straight to disk now)</para>
+        </listitem>
+
+        <listitem>
+          <para>Save turntable sets (.tX - files)</para>
+        </listitem>
+
+        <listitem>
+          <para>Support for the LADSPA-plugin-standard.</para>
+        </listitem>
+
+        <listitem>
+          <para>and more</para>
+        </listitem>
+      </itemizedlist>
+    </sect2>
+
+    <sect2 id="REQUIREMENTS">
+      <title>Requirements</title>
+      
+      <para>To run terminatorX a system should meet the following requirements:</para>
+
+      <itemizedlist>
+        <listitem>
+          <para>Software</para>
+
+          <itemizedlist>
+            <listitem>
+              <para>required</para>
+
+              <itemizedlist>
+                <listitem>
+                  <para>The Linux Operating System (Version &#62;= 2.0) or
+                  FreeBSD</para>
+                </listitem>
+
+                <listitem>
+                  <para>glibc2 (pthreads).</para>
+                </listitem>
+
+                <listitem>
+                  <para>XFree86 (with DGA DirectMouse support). Note that
+                  XFree86 Release 4.0 has a bug resulting in broken
+                  DirectMouse support. This has been fixed by the XFree86-Team
+                  with Release 4.0.1 available from your distribution or the
+                  <ulink url="http://www.xfree86.org">XFree86 homepage</ulink>.</para>
+                </listitem>
+
+                <listitem>
+                  <para>The Gimp Toolkit: gtk+ (&#62;= 1.2.5) - Version 2 of
+                  gtk+ is supported, too. If your distribution doesn&#39;t
+                  provide a current version of gtk+ get it from the <ulink
+                  url="http://www.gtk.org">gtk+ homepage</ulink>.</para>
+                </listitem>
+
+                <listitem>
+                  <para>LADSPA - the Linux Audio Developer&#39;s Simple Plugin
+                  API. Get it from the <ulink url="http://www.ladpsa.org">LADSPA
+                  homepage</ulink></para>
+                </listitem>
+
+                <listitem>
+                  <para>a compiler (gcc)</para>
+                </listitem>
+              </itemizedlist>
+            </listitem>
+
+            <listitem>
+              <para>optional</para>
+
+              <itemizedlist>
+                <listitem>
+                  <para><ulink
+                  url="http://home.sprynet.com/~cbagwell/sox.html">sox</ulink>
+                  for enhanced audio file support</para>
+                </listitem>
+
+                <listitem>
+                  <para><ulink
+                  url="http://www-ti.informatik.uni-tuebingen.de/~hippm/mpg123.html">mpg123</ulink>
+                  for mp3 support</para>
+                </listitem>
+
+                <listitem>
+                  <para><ulink url="http://www.xiph.org/ogg/vorbis/">ogg123</ulink>
+                  for Ogg Vorbis support</para>
+                </listitem>
+              </itemizedlist>
+            </listitem>
+          </itemizedlist>
+        </listitem>
+
+        <listitem>
+          <para>Hardware</para>
+
+          <itemizedlist>
+            <listitem>
+              <para>An OSS compatible soundcard capable of stereo output. This
+              includes <emphasis>all</emphasis> <ulink
+              url="http://www.alsa-project.org">ALSA-driven</ulink> soundcards
+              as this enhanced audio device interface includes support for the
+              OSS API.</para>
+            </listitem>
+
+            <listitem>
+              <para>A good clean mouse and pad, a good X-Pointer setup.</para>
+            </listitem>
+          </itemizedlist>
+        </listitem>
+      </itemizedlist>
+
+      <para>A note on performance: terminatorX is known to run satisfyingly on
+      pentium-class systems (or above of course). Increasing the number of
+      turntables or plugins will of course require more performant systems.</para>
+    </sect2>
+
+    <sect2 id="INSTALLATION">
+      <title>Installation</title>
+
+      <para>For GNU-standards&#39; sake this information is now located in the
+      <filename moreinfo="none">INSTALL</filename> file that came with this
+      distribution of terminatorX.</para>
+    </sect2>
+  </sect1>
+
+  <sect1 id="OPERATION">
+    <title>Operation</title>
+
     <para>With Release Version 3.70 the terminatorX has undergone some
-      redesign again. It's split up in the main controls (master,
-      sequencer, engine controls and menu buttons) and the individual
-      turntable's controls. Each turntable has it's own GUI split up
-      into control and audio panel.</para>
-
-    <section id="MAINCONTROLS"><title>Main Controls</title>
-      <para>The controls of the master gui are located in the top and
-       the right bar of the terminatorX main window.</para>
-      <itemizedlist><listitem><para><emphasis>Audio Engine Power / Mouse
-             Grab</emphasis></para>
-
-         <para>With the Audio Engine Button you can en- and disable the
-           audio playback engine without activating the
-           sequencer. Unlike earlier versions you will not
-           automatically enter mouse-grab mode so you can modify
-           volume/pitch/echo settings etc. while you actually hear what
-           you do. </para>
-
-         <para>Some functions are not available when the audio engine is on, their controls will be marked insensitive when you enable the engine. To actually enter grab mode you'll have to click on the "Mouse Grab" button. See <xref linkend="GRABMODE"/> (Grab Mode Operation) to find out how to control the software then.</para></listitem>
-       <listitem><para><emphasis>Record (Audio
-             Engine)</emphasis></para>
-
-         <para>To enable recording you have to enable the "Record"-toggle button BEFORE you 
-           start the audio engine. You will be prompted for a filename after enabling the
-           button. Audio will then be recorded to that file in stereo
-           RIFF/WAV format from the moment you turn the audio engine on
-           until you turn it off again. Please be aware of the fact
-           that recording audio requires <emphasis>a lot</emphasis> of
-           harddisk space!</para></listitem>
-
-       <listitem><para><emphasis>Sequencer Play / Record / Stop</emphasis></para>
-         <para>Please read the Sequencer-Section to find out more about
-           the sequencer.</para></listitem>
-
-       <listitem><para><emphasis>Master Volume /
-             Pitch</emphasis></para>
-
-         <para>The volume and pitch settings of the individual
-           turntables are relative to these master settings. This
-           information will be stored within the .tX set
-           files.</para></listitem>
-
-       <listitem><para><emphasis>Add Turntable</emphasis></para>
-         <para>Oh well, it says it all: adds a (new) turntable to the
-           current set.</para></listitem>
-
-       <listitem><para><emphasis>Save Set</emphasis></para>
-         <para>With this button you can save your current set and all related settings to a 
-           .tX set file. Note that the audiofiles themselves will not be stored within
-           these files but only references to them. Therefore on loading the set the 
-           audiofiles have to be at the same location in the filesystem as they were when
-           putting that set together.</para></listitem>
-       <listitem><para><emphasis>Load Set</emphasis></para>
-         <para>Loads a previously saved set (see above). The current
-           set will be destroyed!</para></listitem>
-
-       <listitem><para><emphasis>Options</emphasis></para>
-         <para>Displays the options dialog. See
-           <xref linkend="CONFIGURATION"/>
-           (Options/Configuration).</para>
-       </listitem>
-       <listitem><para><emphasis>About/Legal</emphasis></para>
-         <para>Displays a dialog with some info about the prog and the
-           binary itself plus the good old GPL.</para></listitem>
-
-       <listitem><para><emphasis>Quit</emphasis></para>
-         <para>No comment.</para></listitem></itemizedlist></section>
-    <section id="TURNtableCONTROLS"><title>Turntable Controls</title>
-      <para>The turntable GUI contains multiple controls and the
-       realtime displays for each turntable. To save some space on your
-       desktop and to give terminatorX the traditional
-       audio-application look, terminatorX features
-       &quot;knob&quot;-widgets. These widgets work pretty
-       straight-forward: click somewhere within the widget and keep the
-       left mouse-button pressed. Now move the mouse up and down or
-       left and right to increase/decrease the control's value. All
-       those widget are coupled with a text entry field since 3.70,
-       which allows you to enter values directly.</para>
-
-      <para>A turntable is visualized by two panels: the control and the
-       audio panel. These are no longer combined for better layout
-       management.</para>
-      <para>
-       Sometimes you might find a certain audio or control panel
-       unnecessary - simply eating up space. Since release 3.73 it is
-       possible to minimize audio and control panels to the 
-       <emphasis>panel bar</emphasis> with the tiny button with a blue
-       bar icon in the upper right edge of each panel. This bar works
-       just like GNOME's
-       window list or KDE's kicker: When a panel is minimized a button in
-       the bar will appear, representing the minimized window. On
-       clicking this button the button will be removed and the
-       minimized panel is displayed again. When no panels are minimized
-       the panel bar automatically disappears to save display space.
-</para>
-      <section><title>Turntable Audio Panel</title>
-       <para>The complete audio-file loaded into a turntable is
-         displayed in the green-on-black audio-widget. When playing
-         terminatorX will indicate the current position within the
-         sample with a red cursor (a blue/green cursor indicates the
-         turntable is muted).</para>
-
-       <para>Additionaly there are some controls above the audio-display:</para>
-       <itemizedlist><listitem><para><emphasis>Turntable Label</emphasis></para>
-           <para>This label indicates the turntables name. The name can
-             be set via the control panel</para></listitem>
-
-         <listitem><para><emphasis>File Button</emphasis></para>
-           <para>This button holds the name of the audio-file currently
-             loaded. When there's no sample loaded the button will read
-             &quot;NONE&quot; to indicate the current status. 
-             Click on this button to get a menu from which you can
-             load/reload a sound file or run an external soundfile
-             editor. Alternatively you can drag'n'drop
-             files over the audio-display to load
-             them.</para>
-           <itemizedlist>
-             <title>The File Button Menu</title>
-             <listitem><para><emphasis>Load File</emphasis></para>
-               <para>Choose this menu entry to select a soundfile from
-                 the file-selection dialog that will pop-up.
-               </para></listitem>
-
-             <listitem><para><emphasis>Reload File</emphasis></para>
-               <para>Choose this menu entry to re-read the
-                 audio-file.</para></listitem>
-
-             <listitem><para><emphasis>Edit File</emphasis></para>
-               <para>This menu entry will run the external audiofile-editor
-                 (that can be specified via the options-dialog) with
-                 the current audio-file as a parameter. Choose
-                 reload after editing and saving the
-                 file.</para></listitem>
-
-           </itemizedlist>
-         </listitem>
-         
-         <listitem>
-           <para><emphasis>Mouse Mapping</emphasis></para>
-           <para>terminatorX allows mapping misc parameters to the
-             mouse axis of your choice. These mappings will be
-             activated in grab mode, so if you move your mouse in X or
-             Y direction in grab mode the parameters you selected from
-             this menu will be affected (for this turntable). Since
-             Version 3.70 this mappings are no longer hardcoded to
-             built-in controls but available for all parameters that
-             qualify as &quot;mappable&quot;. Note that this includes
-             plugins' controls as
-             well.</para></listitem></itemizedlist></section>
-
-      <section><title>Turntable Controls</title>
-       <para>These controls are now grouped within functional
-         panels. The number of panels depends on the number of plugins
-         loaded. terminatorX allows hiding the controls not required
-         via the yellow triangle button. To un-hide just click the
-         button again. The first panels are the standard controls for a
-         turntable, then follows the dynamic FX-section and below that
-         follow the pitch and volume controls.</para>
-       
-       <section><title>Main Panel</title>
-         <itemizedlist><listitem><para><emphasis>Name Field</emphasis></para>
-             <para>The main panel features a text entry field that
-               allows setting a name for the related turntable. The
-               Labels for the controls and the audio-display will
-               update accordingly.</para></listitem>
-
-           <listitem><para><emphasis>Delete Button</emphasis></para>
-             <para>Pressing this button remove the tunrtable from the
-               current setup. Note that all sequencer events recorded
-               for this turntable will be erased,
-               too.</para></listitem></itemizedlist></section>
-
-       <section><title>Trigger Panel</title>
-         <para>The trigger panel holds all controls related to
-           triggering the turntable. For more details on
-           synchronization see <xref linkend="SYNCHRONIZATION"/>
-           (synchronization).</para>
-
-         <itemizedlist><listitem><para><emphasis>Trigger! Button</emphasis></para>
-             <para>Pressing this button triggers the turntable
-               now. With the audio engine enabled this will cause the
-               turntable to start playing back audio from the beginning
-               of the sample.</para></listitem>
-
-           <listitem><para><emphasis>Stop Button</emphasis></para>
-             <para>Guess what, this stops this turntable's
-               audio-playback.</para></listitem>
-
-           <listitem><para><emphasis>Master Button</emphasis></para>
-             <para>Enabling this button makes this turntable the
-               <emphasis>sync-master</emphasis>. Note that only
-               <emphasis>one</emphasis> turntable at a time can be the
-               sync-master.</para></listitem>
-
-           <listitem><para><emphasis>Client Button</emphasis></para>
-             <para>This button marks the turntable as
-               <emphasis>sync-client</emphasis>, so it will be triggerd
-               with the master automatically.</para></listitem>
-
-           <listitem><para><emphasis>Sync-Cycles Selection</emphasis></para>
-             <para>The sync cycles determine how often a sync-client
-               should be triggered. With a setting of zero the
-               sync-client will be (re-)triggered with
-               <emphasis>every</emphasis> trigger of the sync-master. A
-               setting of 1 will (re-)trigger the client every
-               <emphasis>second</emphasis> master-triger and so
-               on.</para></listitem></itemizedlist>
-
-         <para>Below the effect queue a turntable shows some more controls:
-           <itemizedlist>
-             <listitem>
-               <para><emphasis>Pitch Control</emphasis></para>
-               <para>The pitch control allows setting the default playback
-                 speed for that turntable (the "motor" speed). Negative values
-                 will result in the sample being played backwards.</para>
-             </listitem>
-             <listitem>
-               <para><emphasis>PAN Control</emphasis></para>
-               <para>This parameter allows setting the position of the
-                 turntable's main signal within the stereo panorama.</para>
-             </listitem>
-             <listitem>
-               <para><emphasis>VU Meter</emphasis></para>
-               <para>The displayed signal shows the turntable's current
-                 signal not including the echo-signal which is mixed
-                 separately.</para>
-             </listitem>
-           </itemizedlist>
-
-         </para>
-
-       </section></section>
-      <section><title>The Effect Queue</title>
-       <para>With release 3.70 the effects are no longer hardcoded into
-         the turntable. The effects are now arranged within an
-         per-turntable effect-queue. The effect sequence is
-         configurable by the user. To move an effect to higher position
-         within the queue, press the <emphasis>blue upward arrow
-           button</emphasis>. This will cause the effect to be renderd
-         <emphasis>before</emphasis> the following effects. The
-         <emphasis>blue downward arrow button</emphasis> will move the
-         effect down by one position. It will then be rendered
-         <emphasis>after</emphasis> the preceding effects.</para>
-
-
-       <para>There are two types of effects: the traditional built-in
-         effects (Lowpass and Echo) and LADSPA plugins. The built-in
-         effects are always available and cannot be removed (but
-         disabled). There can be only one instance of a built-in
-         effect. The LADSPA plugins on the other hand may be
-         instanciated multiple times and can be removed from the effect
-         queue. Press the <emphasis>blue cross button</emphasis> to
-         achieve this.</para>
-
-       <figure float="0">
-         <title>An example for a terminatorX effect queue</title>
-         <graphic fileref="figures/signalflow" scale="27"/>
-       </figure>
-       <para>Now since release 3.71 the built-in echo effect is treated
-         differently from other effects. Where all other effects feed
-         their signal back into the effect queue the echo effect
-         doesn't touch the input signal. It's echo-signal is mixed
-         seperately from the turntable's main signal to allow a
-         different panning value for the echo-signal. This mode of
-         operation does have some side-effects: imagine a lowpass
-         filter with a position after the echo effect in the effect
-         queue. This will result in the turntable's main signal being
-         lowpassed but it will leave the echo-signal
-         un-lowpassed.</para>
-
-       <para>Some may call this behaviour a bug - whereas I would
-         consider it a feature ;). Anyway if the above description
-         didn't clear things up maybe the displayed figure does. It
-         shows a schematic effect queue with the built-in effects and
-         two LADSPA effects enabled. Now with this setup you will not
-         hear anything from the second LADSPA effect in the
-         echo-signal.</para>
-
-
-       <para>For more information on a LADSPA plugin, press it's panel's label and a small info box will pop up.</para>
-       <itemizedlist><listitem><para><emphasis>FX Button</emphasis></para>
-           <para>Press this button to load a LADSPA plugin into the
-             effect queue of the turntable. A menu holding the
-             available (terminatorX-&quot;compatible&quot;)
-             LADSPA-plugins will pop up. The plugins are grouped within
-             submenus according to the modules the plugins are
-             contained in. Simply select the plugin you want to load
-             from this menu and a panel for it will pop up at the end
-             of the effect queue.</para>
-
-           <para>Note that due to the wide parameter ranges some LADSPA
-             plugins have they sometimes might be hard to control with
-             the knob widget. In these cases you might want to use the
-             text field to enter values. For more details on Plugins
-             see <xref linkend="LADSPAPLUGINS"/>
-             (LASDPA).</para></listitem></itemizedlist></section>
-
-      <section><title>Lowpass Panel</title>
-       <para>terminatorX features a builtin resonating lowpass filter
-         that can be configured with this panel.</para>
-
-       <itemizedlist><listitem><para><emphasis>Enable Button</emphasis></para>
-           <para>Activating this button will enable the lowpass filter
-             for this turntable.</para></listitem>
-
-         <listitem><para><emphasis>Input Gain Control</emphasis></para>
-           <para>With this parameter you can amplify the signal that
-             goes into the lowpass filter if
-             required.</para></listitem>
-
-         <listitem><para><emphasis>Frequency Control</emphasis></para>
-           <para>Use this parameter to set the cutoff frequency for the
-             lowpass filter. Minimum: 0=0Hz, Maximum:
-             1=22KHz.</para></listitem>
-
-         <listitem><para><emphasis>Resonance</emphasis></para>
-           <para>Use this parameter to set the
-             resonance-value. Minimum: 0=no resonance, Maximum: 1=max
-             resonance.</para></listitem></itemizedlist></section>
-
-      <section><title>Echo Panel</title>
-       <para>Additionaly terminatorX features a built-in echo
-         effect. It can be configured with this panel.</para>
-
-       <itemizedlist><listitem><para><emphasis>Enable
-               Button</emphasis></para>
-
-           <para>Activating this button will enable the echo effect for
-             this turntable.</para></listitem>
-
-         <listitem><para><emphasis>Duration Control</emphasis></para>
-           <para>Use this parameter to set the length of the echo. The
-             duration parameter scales to the actual sample length: so
-             if you set it to 0.5 you will hear the echo when the red
-             playback cursor is half way  through the sample. This is
-             true for samples that are shorter than terminatorX'
-             maximum echo buffer size only.</para></listitem>
-
-         <listitem><para><emphasis>Feedback Control</emphasis></para>
-           <para>Set the echo's feedback amount with this
-             parameter.</para></listitem>
-
-         <listitem><para><emphasis>Volume Control</emphasis></para>
-           <para>This parameter can additionally amplify the echo
-             signal. Unlike the feedback parameter above this parameter
-             has no influence on the signal fed back into the
-             echo-buffer, it effects merely the playback volume of the
-             echo signal.</para></listitem>
-
-         <listitem><para><emphasis>Pan Control</emphasis></para>
-           <para>The echo effect differs from other effects as it's
-             output signal will be mixed seperately. The main goal here
-             is to allow positioning the echo signal at a position in
-             the stereo panorama that differs from the main panning
-             positon of the turntable to achieve a somewhat spacial
-             effect. The easy example is: turntable's panning left,
-             echo's panning right. As both pan parameters are
-             sequencable you can create nice motion effects from this
-             starting point.</para></listitem>
-
-
-       </itemizedlist></section></section>
-    <section id="SYNCHRONIZATION"><title>Synchronization</title>
-      <para>Let's start off with an example: Say you have two drumloops
-       and one bassline loaded in three turntables. Of course you want
-       these samples to be triggered at the same time but you don't
-       want to invest time to cut them to the exact length. Therefore
-       you decide which of the drumloops to make the sync
-       master. You'll have to do this before you enable the audio
-       engine (for now). Only one turntable can be the sync master. Now
-       you can make the other two sync clients which will cause them to
-       be (re-)triggered whenever the master is (re-)triggered. The
-       number you can select to the right of the <emphasis>client
-         button</emphasis> sets the trigger delay for the button: if
-       it's set to zero the turntable will be triggered with every
-       master trigger, if it's set to 1 it'll be triggered every 2nd
-       master trigger and so on.</para>
-
-      <para>A nice side effect of this feature is: you can now scratch
-       the second (sync client) drum loop and no matter whether you're
-       scratching is good or not the beat will be triggered correctly
-       again ;)</para></section>
-
-    <section id="GRABMODE"><title>Grab Mode Operation</title>
+    redesign again. It&#39;s split up in the main controls (master, sequencer,
+    engine controls and menu buttons) and the individual turntable&#39;s
+    controls. Each turntable has it&#39;s own GUI split up into control and
+    audio panel.</para>
+
+    <sect2 id="MAINCONTROLS">
+      <title>Main Controls</title>
+
+      <para>The controls of the master gui are located in the top and the
+      right bar of the terminatorX main window.</para>
+
+      <itemizedlist>
+        <listitem>
+          <para><emphasis>Audio Engine Power / Mouse Grab</emphasis></para>
+
+          <para>With the Audio Engine Button you can en- and disable the audio
+          playback engine without activating the sequencer. Unlike earlier
+          versions you will not automatically enter mouse-grab mode so you can
+          modify volume/pitch/echo settings etc. while you actually hear what
+          you do.</para>
+
+          <para>Some functions are not available when the audio engine is on,
+          their controls will be marked insensitive when you enable the
+          engine. To actually enter grab mode you&#39;ll have to click on the
+          &#34;Mouse Grab&#34; button. See <xref linkend="GRABMODE" /> (Grab
+          Mode Operation) to find out how to control the software then.</para>
+        </listitem>
+
+        <listitem>
+          <para><emphasis>Record (Audio Engine)</emphasis></para>
+
+          <para>To enable recording you have to enable the
+          &#34;Record&#34;-toggle button BEFORE you start the audio engine.
+          You will be prompted for a filename after enabling the button. Audio
+          will then be recorded to that file in stereo RIFF/WAV format from
+          the moment you turn the audio engine on until you turn it off again.
+          Please be aware of the fact that recording audio requires
+          <emphasis>a lot</emphasis> of harddisk space!</para>
+        </listitem>
+
+        <listitem>
+          <para><emphasis>Sequencer Play / Record / Stop</emphasis></para>
+
+          <para>Please read the Sequencer-Section to find out more about the
+          sequencer.</para>
+        </listitem>
+
+        <listitem>
+          <para><emphasis>Master Volume / Pitch</emphasis></para>
+
+          <para>The volume and pitch settings of the individual turntables are
+          relative to these master settings. This information will be stored
+          within the .tX set files.</para>
+        </listitem>
+
+        <listitem>
+          <para><emphasis>Add Turntable</emphasis></para>
+
+          <para>Oh well, it says it all: adds a (new) turntable to the current
+          set.</para>
+        </listitem>
+
+        <listitem>
+          <para><emphasis>Save Set</emphasis></para>
+
+          <para>With this button you can save your current set and all related
+          settings to a .tX set file. Note that the audiofiles themselves will
+          not be stored within these files but only references to them.
+          Therefore on loading the set the audiofiles have to be at the same
+          location in the filesystem as they were when putting that set
+          together.</para>
+        </listitem>
+
+        <listitem>
+          <para><emphasis>Load Set</emphasis></para>
+
+          <para>Loads a previously saved set (see above). The current set will
+          be destroyed!</para>
+        </listitem>
+
+        <listitem>
+          <para><emphasis>Options</emphasis></para>
+
+          <para>Displays the options dialog. See <xref linkend="CONFIGURATION" />
+          (Options/Configuration).</para>
+        </listitem>
+
+        <listitem>
+          <para><emphasis>About/Legal</emphasis></para>
+
+          <para>Displays a dialog with some info about the prog and the binary
+          itself plus the good old GPL.</para>
+        </listitem>
+
+        <listitem>
+          <para><emphasis>Quit</emphasis></para>
+
+          <para>No comment.</para>
+        </listitem>
+      </itemizedlist>
+    </sect2>
+
+    <sect2 id="TURNtableCONTROLS">
+      <title>Turntable Controls</title>
+
+      <para>The turntable GUI contains multiple controls and the realtime
+      displays for each turntable. To save some space on your desktop and to
+      give terminatorX the traditional audio-application look, terminatorX
+      features &#34;knob&#34;-widgets. These widgets work pretty
+      straight-forward: click somewhere within the widget and keep the left
+      mouse-button pressed. Now move the mouse up and down or left and right
+      to increase/decrease the control&#39;s value. All those widget are
+      coupled with a text entry field since 3.70, which allows you to enter
+      values directly.</para>
+
+      <para>A turntable is visualized by two panels: the control and the audio
+      panel. These are no longer combined for better layout management.</para>
+
+      <para>Sometimes you might find a certain audio or control panel
+      unnecessary - simply eating up space. Since release 3.73 it is possible
+      to minimize audio and control panels to the <emphasis>panel bar</emphasis>
+      with the tiny button with a blue bar icon in the upper right edge of
+      each panel. This bar works just like GNOME&#39;s window list or
+      KDE&#39;s kicker: When a panel is minimized a button in the bar will
+      appear, representing the minimized window. On clicking this button the
+      button will be removed and the minimized panel is displayed again. When
+      no panels are minimized the panel bar automatically disappears to save
+      display space.</para>
+
+      <sect3>
+        <title>Turntable Audio Panel</title>
+
+        <para>The complete audio-file loaded into a turntable is displayed in
+        the green-on-black audio-widget. When playing terminatorX will
+        indicate the current position within the sample with a red cursor (a
+        blue/green cursor indicates the turntable is muted).</para>
+
+        <para>Additionaly there are some controls above the audio-display:</para>
+
+        <itemizedlist>
+          <listitem>
+            <para><emphasis>Turntable Label</emphasis></para>
+
+            <para>This label indicates the turntables name. The name can be
+            set via the control panel</para>
+          </listitem>
+
+          <listitem>
+            <para><emphasis>File Button</emphasis></para>
+
+            <para>This button holds the name of the audio-file currently
+            loaded. When there&#39;s no sample loaded the button will read
+            &#34;NONE&#34; to indicate the current status. Click on this
+            button to get a menu from which you can load/reload a sound file
+            or run an external soundfile editor. Alternatively you can
+            drag&#39;n&#39;drop files over the audio-display to load them.</para>
+
+            <itemizedlist>
+              <title>The File Button Menu</title>
+
+              <listitem>
+                <para><emphasis>Load File</emphasis></para>
+
+                <para>Choose this menu entry to select a soundfile from the
+                file-selection dialog that will pop-up.</para>
+              </listitem>
+
+              <listitem>
+                <para><emphasis>Reload File</emphasis></para>
+
+                <para>Choose this menu entry to re-read the audio-file.</para>
+              </listitem>
+
+              <listitem>
+                <para><emphasis>Edit File</emphasis></para>
+
+                <para>This menu entry will run the external audiofile-editor
+                (that can be specified via the options-dialog) with the
+                current audio-file as a parameter. Choose reload after editing
+                and saving the file.</para>
+              </listitem>
+            </itemizedlist>
+          </listitem>
+
+          <listitem>
+            <para><emphasis>Mouse Mapping</emphasis></para>
+
+            <para>terminatorX allows mapping misc parameters to the mouse axis
+            of your choice. These mappings will be activated in grab mode, so
+            if you move your mouse in X or Y direction in grab mode the
+            parameters you selected from this menu will be affected (for this
+            turntable). Since Version 3.70 this mappings are no longer
+            hardcoded to built-in controls but available for all parameters
+            that qualify as &#34;mappable&#34;. Note that this includes
+            plugins&#39; controls as well.</para>
+          </listitem>
+        </itemizedlist>
+      </sect3>
+
+      <sect3>
+        <title>Turntable Controls</title>
+
+        <para>These controls are now grouped within functional panels. The
+        number of panels depends on the number of plugins loaded. terminatorX
+        allows hiding the controls not required via the yellow triangle
+        button. To un-hide just click the button again. The first panels are
+        the standard controls for a turntable, then follows the dynamic
+        FX-section and below that follow the pitch and volume controls.</para>
+
+        <sect4>
+          <title>Main Panel</title>
+
+          <itemizedlist>
+            <listitem>
+              <para><emphasis>Name Field</emphasis></para>
+
+              <para>The main panel features a text entry field that allows
+              setting a name for the related turntable. The Labels for the
+              controls and the audio-display will update accordingly.</para>
+            </listitem>
+
+            <listitem>
+              <para><emphasis>Delete Button</emphasis></para>
+
+              <para>Pressing this button remove the tunrtable from the current
+              setup. Note that all sequencer events recorded for this
+              turntable will be erased, too.</para>
+            </listitem>
+          </itemizedlist>
+        </sect4>
+
+        <sect4>
+          <title>Trigger Panel</title>
+
+          <para>The trigger panel holds all controls related to triggering the
+          turntable. For more details on synchronization see <xref
+          linkend="SYNCHRONIZATION" /> (synchronization).</para>
+
+          <itemizedlist>
+            <listitem>
+              <para><emphasis>Trigger! Button</emphasis></para>
+
+              <para>Pressing this button triggers the turntable now. With the
+              audio engine enabled this will cause the turntable to start
+              playing back audio from the beginning of the sample.</para>
+            </listitem>
+
+            <listitem>
+              <para><emphasis>Stop Button</emphasis></para>
+
+              <para>Guess what, this stops this turntable&#39;s
+              audio-playback.</para>
+            </listitem>
+
+            <listitem>
+              <para><emphasis>Master Button</emphasis></para>
+
+              <para>Enabling this button makes this turntable the
+              <emphasis>sync-master</emphasis>. Note that only
+              <emphasis>one</emphasis> turntable at a time can be the
+              sync-master.</para>
+            </listitem>
+
+            <listitem>
+              <para><emphasis>Client Button</emphasis></para>
+
+              <para>This button marks the turntable as <emphasis>sync-client</emphasis>,
+              so it will be triggerd with the master automatically.</para>
+            </listitem>
+
+            <listitem>
+              <para><emphasis>Sync-Cycles Selection</emphasis></para>
+
+              <para>The sync cycles determine how often a sync-client should
+              be triggered. With a setting of zero the sync-client will be
+              (re-)triggered with <emphasis>every</emphasis> trigger of the
+              sync-master. A setting of 1 will (re-)trigger the client every
+              <emphasis>second</emphasis> master-triger and so on.</para>
+            </listitem>
+          </itemizedlist>
+
+          <para>Below the effect queue a turntable shows some more controls:
+          <itemizedlist><listitem><para><emphasis>Pitch Control</emphasis></para><para>The
+          pitch control allows setting the default playback speed for that
+          turntable (the &#34;motor&#34; speed). Negative values will result
+          in the sample being played backwards.</para></listitem><listitem><para><emphasis>PAN
+          Control</emphasis></para><para>This parameter allows setting the
+          position of the turntable&#39;s main signal within the stereo
+          panorama.</para></listitem><listitem><para><emphasis>VU Meter</emphasis></para><para>The
+          displayed signal shows the turntable&#39;s current signal not
+          including the echo-signal which is mixed separately.</para></listitem></itemizedlist></para>
+        </sect4>
+      </sect3>
+
+      <sect3>
+        <title>The Effect Queue</title>
+
+        <para>With release 3.70 the effects are no longer hardcoded into the
+        turntable. The effects are now arranged within an per-turntable
+        effect-queue. The effect sequence is configurable by the user. To move
+        an effect to higher position within the queue, press the
+        <emphasis>blue upward arrow button</emphasis>. This will cause the
+        effect to be renderd <emphasis>before</emphasis> the following
+        effects. The <emphasis>blue downward arrow button</emphasis> will move
+        the effect down by one position. It will then be rendered
+        <emphasis>after</emphasis> the preceding effects.</para>
+
+        <para>There are two types of effects: the traditional built-in effects
+        (Lowpass and Echo) and LADSPA plugins. The built-in effects are always
+        available and cannot be removed (but disabled). There can be only one
+        instance of a built-in effect. The LADSPA plugins on the other hand
+        may be instanciated multiple times and can be removed from the effect
+        queue. Press the <emphasis>blue cross button</emphasis> to achieve
+        this.</para>
+
+        <figure float="0">
+          <title>An example for a terminatorX effect queue</title>
+
+          <graphic fileref="figures/signalflow.png" format="PNG" />
+        </figure>
+
+        <para>Now since release 3.71 the built-in echo effect is treated
+        differently from other effects. Where all other effects feed their
+        signal back into the effect queue the echo effect doesn&#39;t touch
+        the input signal. It&#39;s echo-signal is mixed seperately from the
+        turntable&#39;s main signal to allow a different panning value for the
+        echo-signal. This mode of operation does have some side-effects:
+        imagine a lowpass filter with a position after the echo effect in the
+        effect queue. This will result in the turntable&#39;s main signal
+        being lowpassed but it will leave the echo-signal un-lowpassed.</para>
+
+        <para>Some may call this behaviour a bug - whereas I would consider it
+        a feature ;). Anyway if the above description didn&#39;t clear things
+        up maybe the displayed figure does. It shows a schematic effect queue
+        with the built-in effects and two LADSPA effects enabled. Now with
+        this setup you will not hear anything from the second LADSPA effect in
+        the echo-signal.</para>
+
+        <para>For more information on a LADSPA plugin, press it&#39;s
+        panel&#39;s label and a small info box will pop up.</para>
+
+        <itemizedlist>
+          <listitem>
+            <para><emphasis>FX Button</emphasis></para>
+
+            <para>Press this button to load a LADSPA plugin into the effect
+            queue of the turntable. A menu holding the available
+            (terminatorX-&#34;compatible&#34;) LADSPA-plugins will pop up. The
+            plugins are grouped within submenus according to the modules the
+            plugins are contained in. Simply select the plugin you want to
+            load from this menu and a panel for it will pop up at the end of
+            the effect queue.</para>
+
+            <para>Note that due to the wide parameter ranges some LADSPA
+            plugins have they sometimes might be hard to control with the knob
+            widget. In these cases you might want to use the text field to
+            enter values. For more details on Plugins see <xref
+            linkend="LADSPAPLUGINS" /> (LASDPA).</para>
+          </listitem>
+        </itemizedlist>
+      </sect3>
+
+      <sect3>
+        <title>Lowpass Panel</title>
+
+        <para>terminatorX features a builtin resonating lowpass filter that
+        can be configured with this panel.</para>
+
+        <itemizedlist>
+          <listitem>
+            <para><emphasis>Enable Button</emphasis></para>
+
+            <para>Activating this button will enable the lowpass filter for
+            this turntable.</para>
+          </listitem>
+
+          <listitem>
+            <para><emphasis>Input Gain Control</emphasis></para>
+
+            <para>With this parameter you can amplify the signal that goes
+            into the lowpass filter if required.</para>
+          </listitem>
+
+          <listitem>
+            <para><emphasis>Frequency Control</emphasis></para>
+
+            <para>Use this parameter to set the cutoff frequency for the
+            lowpass filter. Minimum: 0=0Hz, Maximum: 1=22KHz.</para>
+          </listitem>
+
+          <listitem>
+            <para><emphasis>Resonance</emphasis></para>
+
+            <para>Use this parameter to set the resonance-value. Minimum: 0=no
+            resonance, Maximum: 1=max resonance.</para>
+          </listitem>
+        </itemizedlist>
+      </sect3>
+
+      <sect3>
+        <title>Echo Panel</title>
+
+        <para>Additionaly terminatorX features a built-in echo effect. It can
+        be configured with this panel.</para>
+
+        <itemizedlist>
+          <listitem>
+            <para><emphasis>Enable Button</emphasis></para>
+
+            <para>Activating this button will enable the echo effect for this
+            turntable.</para>
+          </listitem>
+
+          <listitem>
+            <para><emphasis>Duration Control</emphasis></para>
+
+            <para>Use this parameter to set the length of the echo. The
+            duration parameter scales to the actual sample length: so if you
+            set it to 0.5 you will hear the echo when the red playback cursor
+            is half way through the sample. This is true for samples that are
+            shorter than terminatorX&#39; maximum echo buffer size only.</para>
+          </listitem>
+
+          <listitem>
+            <para><emphasis>Feedback Control</emphasis></para>
+
+            <para>Set the echo&#39;s feedback amount with this parameter.</para>
+          </listitem>
+
+          <listitem>
+            <para><emphasis>Volume Control</emphasis></para>
+
+            <para>This parameter can additionally amplify the echo signal.
+            Unlike the feedback parameter above this parameter has no
+            influence on the signal fed back into the echo-buffer, it effects
+            merely the playback volume of the echo signal.</para>
+          </listitem>
+
+          <listitem>
+            <para><emphasis>Pan Control</emphasis></para>
+
+            <para>The echo effect differs from other effects as it&#39;s
+            output signal will be mixed seperately. The main goal here is to
+            allow positioning the echo signal at a position in the stereo
+            panorama that differs from the main panning positon of the
+            turntable to achieve a somewhat spacial effect. The easy example
+            is: turntable&#39;s panning left, echo&#39;s panning right. As
+            both pan parameters are sequencable you can create nice motion
+            effects from this starting point.</para>
+          </listitem>
+        </itemizedlist>
+      </sect3>
+    </sect2>
+
+    <sect2 id="SYNCHRONIZATION">
+      <title>Synchronization</title>
+
+      <para>Let&#39;s start off with an example: Say you have two drumloops
+      and one bassline loaded in three turntables. Of course you want these
+      samples to be triggered at the same time but you don&#39;t want to
+      invest time to cut them to the exact length. Therefore you decide which
+      of the drumloops to make the sync master. You&#39;ll have to do this
+      before you enable the audio engine (for now). Only one turntable can be
+      the sync master. Now you can make the other two sync clients which will
+      cause them to be (re-)triggered whenever the master is (re-)triggered.
+      The number you can select to the right of the <emphasis>client button</emphasis>
+      sets the trigger delay for the button: if it&#39;s set to zero the
+      turntable will be triggered with every master trigger, if it&#39;s set
+      to 1 it&#39;ll be triggered every 2nd master trigger and so on.</para>
+
+      <para>A nice side effect of this feature is: you can now scratch the
+      second (sync client) drum loop and no matter whether you&#39;re
+      scratching is good or not the beat will be triggered correctly again ;)</para>
+    </sect2>
+
+    <sect2 id="GRABMODE">
+      <title>Grab Mode Operation</title>
+
       <para>After pressing the <emphasis>Mouse Grab button</emphasis>
-       terminatorX enters "grab mode". This mode actually locks the
-       mouse (as this input is now used to control the realtime
-       parameters) and therefore you'll have to know some
-       mouse/keyboard shortcuts to control the software without the
-       GUI.</para>
-
-      <para>Press <keycap moreinfo="NONE">ESCAPE</keycap> to quit grab mode.</para>
-      <para>Select the turntable with input focus: The first turntable
-       to hold the input focus will be the first turntable. You can now
-       use <keycap moreinfo="NONE">TAB</keycap> or right mouse button
-       to switch to the next turntable. Alternativley you can use
-       <keycap moreinfo="NONE">F1</keycap> to 
-       <keycap moreinfo="NONE">F12</keycap> to select turtntable 1 to 12.</para>
+      terminatorX enters &#34;grab mode&#34;. This mode actually locks the
+      mouse (as this input is now used to control the realtime parameters) and
+      therefore you&#39;ll have to know some mouse/keyboard shortcuts to
+      control the software without the GUI.</para>
+
+      <para>Press <keycap moreinfo="none">ESCAPE</keycap> to quit grab mode.</para>
+
+      <para>Select the turntable with input focus: The first turntable to hold
+      the input focus will be the first turntable. You can now use <keycap
+      moreinfo="none">TAB</keycap> or right mouse button to switch to the next
+      turntable. Alternativley you can use <keycap moreinfo="none">F1</keycap>
+      to <keycap moreinfo="none">F12</keycap> to select turtntable 1 to 12.</para>
 
       <para>Now the turntable that has the focus is the one you will
-       manipulate with your mouse and keyboard inputs: Note that you
-       can actually map different functions to the mouse x/y axis - so
-       what actually happens when you move your mouse depends on what
-       you select on the x/y control panels for each turntable.</para>
-
-      <table><title>Keyboard Controls in Grab Mode</title>
-       <tgroup COLS="2"><thead><row><entry>Key</entry>
-             <entry>Function</entry></row></thead>
-         <tbody><row><entry><keycap moreinfo="NONE">TAB</keycap></entry>
-             <entry>select next turntable</entry></row>
-           <row><entry><keycap moreinfo="NONE">F1</keycap> to
-               <keycap moreinfo="NONE">F12</keycap></entry>
-             <entry>select turntable 1 to 12</entry></row>
-           <row><entry><keycap moreinfo="NONE">RETURN</keycap></entry>
-             <entry>triggers the turntable</entry></row>
-           <row><entry><keycap moreinfo="NONE">BACKSPACE</keycap></entry>
-             <entry>stops the turntable</entry></row>
-           <row><entry><keycap moreinfo="NONE">S</keycap></entry>
-             <entry>toggles "Sync Client"</entry></row>
-           <row><entry><keycap moreinfo="NONE">SPACE</keycap></entry>
-             <entry>while pressed turntable speed is mapped to mouse
-               speed (scratching!)</entry></row>
-
-           <row><entry><keycap moreinfo="NONE">ALT</keycap></entry>
-             <entry>mute on/off</entry></row>
-           <row><entry><keycap moreinfo="NONE">CTRL</keycap></entry>
-             <entry>mute on/off (inverted)</entry></row>
-           <row><entry><keycap moreinfo="NONE">F</keycap></entry>
-             <entry>("fast") warp mode (while scratching)</entry></row>
-           <row><entry><keycap moreinfo="NONE">W</keycap></entry>
-             <entry>same as above but the audio will be muted while
-               warping</entry></row></tbody></tgroup></table>
-
-      <table><title>Mouse Button Controls in Grab Mode</title>
-       <tgroup COLS="2"><thead><row><entry>Mouse Button</entry>
-             <entry>Function</entry></row></thead>
-         <tbody><row><entry><emphasis>Left button</emphasis></entry>
-             <entry>same as <keycap moreinfo="NONE">SPACE</keycap>:
-               scratching (triggers the turntable when
-               stopped)</entry></row>
-
-           <row><entry><emphasis>Right button</emphasis></entry>
-             <entry>select next turntable</entry></row>
-           <row><entry><emphasis>Middle button</emphasis></entry>
-             <entry>mute on/off</entry></row></tbody></tgroup></table>
-      <para>Scratching works as before: press <keycap
-                                                     moreinfo="NONE">SPACE</keycap> or left mouse button to actually scratch: now your mouse controls the turntables speed. Release it to let that turntable spin at default speed again.</para></section>
-
-    <section id="DRAGNDROP"><title>Drag And Drop</title>
-      <para>Since V3.55 terminatorX provides multiple DND-Drop-Targets
-       for use with GNOME / gmc (gmc is the GNU Midnight Commander),
-       Nautilus or the Elightenment File Manager (efm). You can load an
-       audiofile into an existing turntable by dragging it from a gmc
-       (or efm or whatever)-window and drop it  over a. the
-       <emphasis>file button</emphasis> (audio-display) or b. (the
-       easier target ;) over the audio-display (the green on black
-       widget that displays the audiodata).</para>
+      manipulate with your mouse and keyboard inputs: Note that you can
+      actually map different functions to the mouse x/y axis - so what
+      actually happens when you move your mouse depends on what you select on
+      the x/y control panels for each turntable.</para>
+
+      <table>
+        <title>Keyboard Controls in Grab Mode</title>
+
+        <tgroup cols="2">
+          <thead>
+            <row>
+              <entry>Key</entry>
+
+              <entry>Function</entry>
+            </row>
+          </thead>
+
+          <tbody>
+            <row>
+              <entry><keycap moreinfo="none">TAB</keycap></entry>
+
+              <entry>select next turntable</entry>
+            </row>
+
+            <row>
+              <entry><keycap moreinfo="none">F1</keycap> to <keycap
+              moreinfo="none">F12</keycap></entry>
+
+              <entry>select turntable 1 to 12</entry>
+            </row>
+
+            <row>
+              <entry><keycap moreinfo="none">RETURN</keycap></entry>
+
+              <entry>triggers the turntable</entry>
+            </row>
+
+            <row>
+              <entry><keycap moreinfo="none">BACKSPACE</keycap></entry>
+
+              <entry>stops the turntable</entry>
+            </row>
+
+            <row>
+              <entry><keycap moreinfo="none">S</keycap></entry>
+
+              <entry>toggles &#34;Sync Client&#34;</entry>
+            </row>
+
+            <row>
+              <entry><keycap moreinfo="none">SPACE</keycap></entry>
+
+              <entry>while pressed turntable speed is mapped to mouse speed
+              (scratching!)</entry>
+            </row>
+
+            <row>
+              <entry><keycap moreinfo="none">ALT</keycap></entry>
+
+              <entry>mute on/off</entry>
+            </row>
+
+            <row>
+              <entry><keycap moreinfo="none">CTRL</keycap></entry>
+
+              <entry>mute on/off (inverted)</entry>
+            </row>
+
+            <row>
+              <entry><keycap moreinfo="none">F</keycap></entry>
+
+              <entry>(&#34;fast&#34;) warp mode (while scratching)</entry>
+            </row>
+
+            <row>
+              <entry><keycap moreinfo="none">W</keycap></entry>
+
+              <entry>same as above but the audio will be muted while warping</entry>
+            </row>
+          </tbody>
+        </tgroup>
+      </table>
+
+      <table>
+        <title>Mouse Button Controls in Grab Mode</title>
+
+        <tgroup cols="2">
+          <thead>
+            <row>
+              <entry>Mouse Button</entry>
+
+              <entry>Function</entry>
+            </row>
+          </thead>
+
+          <tbody>
+            <row>
+              <entry><emphasis>Left button</emphasis></entry>
+
+              <entry>same as <keycap moreinfo="none">SPACE</keycap>:
+              scratching (triggers the turntable when stopped)</entry>
+            </row>
+
+            <row>
+              <entry><emphasis>Right button</emphasis></entry>
+
+              <entry>select next turntable</entry>
+            </row>
+
+            <row>
+              <entry><emphasis>Middle button</emphasis></entry>
+
+              <entry>mute on/off</entry>
+            </row>
+          </tbody>
+        </tgroup>
+      </table>
+
+      <para>Scratching works as before: press <keycap moreinfo="none">SPACE</keycap>
+      or left mouse button to actually scratch: now your mouse controls the
+      turntables speed. Release it to let that turntable spin at default speed
+      again.</para>
+    </sect2>
+
+    <sect2 id="DRAGNDROP">
+      <title>Drag And Drop</title>
+
+      <para>Since V3.55 terminatorX provides multiple DND-Drop-Targets for use
+      with GNOME / gmc (gmc is the GNU Midnight Commander), Nautilus or the
+      Elightenment File Manager (efm). You can load an audiofile into an
+      existing turntable by dragging it from a gmc (or efm or whatever)-window
+      and drop it over a. the <emphasis>file button</emphasis> (audio-display)
+      or b. (the easier target ;) over the audio-display (the green on black
+      widget that displays the audiodata).</para>
 
       <para>To add a file to the set (== to load the file into a *new*
-       turntable) simply drop the audiofile over the "New Turntable"
-       Button. To load a complete terminatorX-set simply drop the
-       setfile (*.tX) over the "Load Set" button.</para></section>
-
-    <section id="SEQUENCER"><title>The Sequencer</title>
-      <para>Release 3.60 introduced the sequencer. It can record and
-       play back events for the following parameters:</para>
-
-      <itemizedlist><listitem><para>master volume &amp; pitch</para></listitem>
-       <listitem><para>scratching</para></listitem>
-       <listitem><para>(turntable) volume &amp; pitch</para></listitem>
-       <listitem><para>triggers</para></listitem>
-       <listitem><para>loop (on/off)</para></listitem>
-       <listitem><para>sync client settings</para></listitem>
-       <listitem><para>muting</para></listitem>
-       <listitem><para><emphasis>all</emphasis> parameters for the
-           effects. This includes built-in effects (lowpass and echo)
-           as well as LADSPA plugins.</para></listitem></itemizedlist>
-
-      <para>To record events simply press the
-       <emphasis>Record</emphasis> button of the sequencer, then press
-       the <emphasis>Play</emphasis> button. All actions (for
-       sequencable parameters - see above) you now take will be
-       recorded into the song list. Press <emphasis>Stop</emphasis> and
-       <emphasis>Play</emphasis> again to see/hear how terminatorX
-       plays back the events recorded before. You can now record events
-       again for e.g. another turntable or record other parameters for
-       the same turntable - whatever you want to do. Recording events
-       for parameters for wich events have been recorded before will
-       result in dubbing: if you touch a parameter while recording,
-       events previously recorded will be erased from the moment you
-       touch the paramater until you stop recording.</para>
+      turntable) simply drop the audiofile over the &#34;New Turntable&#34;
+      Button. To load a complete terminatorX-set simply drop the setfile
+      (*.tX) over the &#34;Load Set&#34; button.</para>
+    </sect2>
+
+    <sect2 id="SEQUENCER">
+      <title>The Sequencer</title>
+
+      <para>Release 3.60 introduced the sequencer. It can record and play back
+      events for the following parameters:</para>
+
+      <itemizedlist>
+        <listitem>
+          <para>master volume &#38; pitch</para>
+        </listitem>
+
+        <listitem>
+          <para>scratching</para>
+        </listitem>
+
+        <listitem>
+          <para>(turntable) volume &#38; pitch</para>
+        </listitem>
+
+        <listitem>
+          <para>triggers</para>
+        </listitem>
+
+        <listitem>
+          <para>loop (on/off)</para>
+        </listitem>
+
+        <listitem>
+          <para>sync client settings</para>
+        </listitem>
+
+        <listitem>
+          <para>muting</para>
+        </listitem>
+
+        <listitem>
+          <para><emphasis>all</emphasis> parameters for the effects. This
+          includes built-in effects (lowpass and echo) as well as LADSPA
+          plugins.</para>
+        </listitem>
+      </itemizedlist>
+
+      <para>To record events simply press the <emphasis>Record</emphasis>
+      button of the sequencer, then press the <emphasis>Play</emphasis>
+      button. All actions (for sequencable parameters - see above) you now
+      take will be recorded into the song list. Press <emphasis>Stop</emphasis>
+      and <emphasis>Play</emphasis> again to see/hear how terminatorX plays
+      back the events recorded before. You can now record events again for
+      e.g. another turntable or record other parameters for the same turntable
+      - whatever you want to do. Recording events for parameters for wich
+      events have been recorded before will result in dubbing: if you touch a
+      parameter while recording, events previously recorded will be erased
+      from the moment you touch the paramater until you stop recording.</para>
 
       <para>When recording long sequences/songs you can use the
-       sequencer-scale to start recording/playback from any
-       song-position you want. To record a single paramteter value at a
-       certain position simply move the sequencer-scale to that
-       position, press <emphasis>Record,</emphasis> set the parameter
-       and press <emphasis>Stop</emphasis> again.</para>
-
-      <para>There is no other the way to edit the sequencer events
-       currently, but future releases may feature an event-list
-       editor.</para></section>
-
-    <section id="LADSPAPLUGINS"><title>Plugins (LADSPA)</title>
-      <para>Since release 3.70 terminatorX supports
-       LADSPA-plugins. LADSPA is the &quot;Linux Audio Developer's
-       Simple Plugin API&quot; which was designed by developers on the
-       Linux-Audio-Developer-Mailinglist and is maintained by Richard
-       W.E. Furse. For more information on LADSPA, other LADSPA-hosts
-       and LADSPA-plugins checkout the 
-       <ulink url="http://www.ladspa.org">LADSPA homepage</ulink>.</para>
+      sequencer-scale to start recording/playback from any song-position you
+      want. To record a single paramteter value at a certain position simply
+      move the sequencer-scale to that position, press <emphasis>Record,</emphasis>
+      set the parameter and press <emphasis>Stop</emphasis> again.</para>
+
+      <para>There is no other the way to edit the sequencer events currently,
+      but future releases may feature an event-list editor.</para>
+    </sect2>
+
+    <sect2 id="LADSPAPLUGINS">
+      <title>Plugins (LADSPA)</title>
+
+      <para>Since release 3.70 terminatorX supports LADSPA-plugins. LADSPA is
+      the &#34;Linux Audio Developer&#39;s Simple Plugin API&#34; which was
+      designed by developers on the Linux-Audio-Developer-Mailinglist and is
+      maintained by Richard W.E. Furse. For more information on LADSPA, other
+      LADSPA-hosts and LADSPA-plugins checkout the <ulink
+      url="http://www.ladspa.org">LADSPA homepage</ulink>.</para>
 
       <para>Not every plugin is supported by terminatorX though. As the
-       plugins are inserted into the per-turntable effect-queue, they
-       have to be mono plugins (as is that queue) for now. This is why
-       terminatorX will load plugins with <emphasis>one</emphasis>
-       audio-in port and <emphasis>one</emphasis> audio-out port
-       only.</para>
-
-      <para>The decision on wether a plugin is terminatorX-suitable is
-       made on terminatorX startup, so only plugins that fit into the
-       effect queue will be offered in the plugin-menu that pops up
-       when the <emphasis>FX</emphasis> button is clicked. On startup
-       terminatorX will print some information on the LADSPA-plugins
-       analysis process to the standard output. Watch the terminal you
-       run terminatorX from for that info if you have problems loading
-       a plugin.</para>
-
-      <para>As specified in the LADSPA-standard LADSPA-plugins can be
-       located in multiple directories across the filesystem. To enable
-       LADSPA-hosts to find those plugins you have to set the
-       environment variable <ENVAR>LADSPA_PATH</ENVAR>
-       accordingly. Let's say you store your plugins in 
-       <filename moreinfo="NONE">/usr/lib/ladspa</filename>
-       and <filename moreinfo="NONE">/home/yourlogin/plugins</filename>
-       then you would have to set:</para>
-
-
-      <para><ENVAR>LADSPA_PATH</ENVAR>=
-       <filename moreinfo="NONE">/usr/lib/ladspa:/home/yourlogin/plugins</filename></para>
-      <para>As a fallback terminatorX will look in the standard
-       directories <filename moreinfo="NONE">/usr/lib/ladspa</filename>
-       and <filename moreinfo="NONE">/usr/local/lib/ladspa</filename>
-       if the environment variable  is not set. Note that this is just
-       a convenience-function, in order for other LADSPA-hosts to work
-       properly, be sure to set your <ENVAR>LADSPA_PATH</ENVAR>
-       correctly. It is a good idea to do that from somewhere in your
-       system configuration (either in your rc-scripts or 
-       <filename moreinfo="NONE">/etc/profile</filename> 
-       or whereever you perefer).</para></section></section>
-
-  <section id="CONFIGURATION"><title>Configuration</title>
-    <para>All configuration business now happens in the
-      Options-dialog. The features that are not completely
-      self-explaining do have tooltips.</para>
-
-    <para>A word on the settings in general: your settings are stored in
-      the file <filename
-                        moreinfo="NONE">~/.terminatorX3rc.bin</filename> so if you think you completely messed up your settings you will have to exit terminatorX - delete this file - and then re-run terminatorX with the default settings.</para>
-
-    <section id="AUDIOSETUP"><title>Audio Setup</title>
+      plugins are inserted into the per-turntable effect-queue, they have to
+      be mono plugins (as is that queue) for now. This is why terminatorX will
+      load plugins with <emphasis>one</emphasis> audio-in port and
+      <emphasis>one</emphasis> audio-out port only.</para>
+
+      <para>The decision on wether a plugin is terminatorX-suitable is made on
+      terminatorX startup, so only plugins that fit into the effect queue will
+      be offered in the plugin-menu that pops up when the
+      <emphasis>FX</emphasis> button is clicked. On startup terminatorX will
+      print some information on the LADSPA-plugins analysis process to the
+      standard output. Watch the terminal you run terminatorX from for that
+      info if you have problems loading a plugin.</para>
+
+      <para>As specified in the LADSPA-standard LADSPA-plugins can be located
+      in multiple directories across the filesystem. To enable LADSPA-hosts to
+      find those plugins you have to set the environment variable
+      <envar>LADSPA_PATH</envar> accordingly. Let&#39;s say you store your
+      plugins in <filename moreinfo="none">/usr/lib/ladspa</filename> and
+      <filename moreinfo="none">/home/yourlogin/plugins</filename> then you
+      would have to set:</para>
+
+      <para><envar>LADSPA_PATH</envar>=<filename moreinfo="none">/usr/lib/ladspa:/home/yourlogin/plugins</filename></para>
+
+      <para>As a fallback terminatorX will look in the standard directories
+      <filename moreinfo="none">/usr/lib/ladspa</filename> and <filename
+      moreinfo="none">/usr/local/lib/ladspa</filename> if the environment
+      variable is not set. Note that this is just a convenience-function, in
+      order for other LADSPA-hosts to work properly, be sure to set your
+      <envar>LADSPA_PATH</envar> correctly. It is a good idea to do that from
+      somewhere in your system configuration (either in your rc-scripts or
+      <filename moreinfo="none">/etc/profile</filename> or whereever you
+      perefer).</para>
+    </sect2>
+  </sect1>
+
+  <sect1 id="CONFIGURATION">
+    <title>Configuration</title>
+
+    <para>All configuration business now happens in the Options-dialog. The
+    features that are not completely self-explaining do have tooltips.</para>
+
+    <para>A word on the settings in general: your settings are stored in the
+    file <filename moreinfo="none">~/.terminatorX3rc.bin</filename> so if you
+    think you completely messed up your settings you will have to exit
+    terminatorX - delete this file - and then re-run terminatorX with the
+    default settings.</para>
+
+    <sect2 id="AUDIOSETUP">
+      <title>Audio Setup</title>
+
       <para>TerminatorX renders audio blockwise. If you want to have
-       near-realtime operation you need to have really small
-       blocks. The values of these blocks can be influenced via the
-       <emphasis>buffer size</emphasis> option. The setting you select
-       actually results in a 2^x blocksize (size-setting == 8 -> true
-       buffer size in bytes is 2^8=256).</para>
-
-      <para>The problem is the smaller the value you select is the
-       faster your machine has to be. So if you here "clicks", or
-       "drops" in audio output that are not related to your
-       sample-material you will have to increase the buffer size. On
-       the other hand if you believe terminatorX does not react fast
-       enough you have to decrease this parameter. The default value is
-       8, but as my machine handles 7 nicely (running with root
-       privileges for realtime scheduling) I use 7.</para></section>
-
-    <section id="MOUSEINPUTSETUP"><title>Mouse/Input Setup</title>
-      <para>Between rendering and outputing these blocks terminatorX
-       checks for mouse motion. The problem with mice is: they don't
-       report when they have stopped. This is why terminatorX assumes
-       your mouse has stopped if there is no motion reported for
-       certain amount of render/output-cycles. This value is
-       configurable via the <emphasis>Stop-sense-cycles</emphasis>
-       option. If you decrease your buffsize of course you shorten the
-       cycle time as well, therefore if you here strange stop/run
-       behaviour of the audio ouput while scratching after you
-       decreased the buffersize you might have to increase the
-       stop-sense value too.</para>
+      near-realtime operation you need to have really small blocks. The values
+      of these blocks can be influenced via the <emphasis>buffer size</emphasis>
+      option. The setting you select actually results in a 2^x blocksize
+      (size-setting == 8 -&#62; true buffer size in bytes is 2^8=256).</para>
+
+      <para>The problem is the smaller the value you select is the faster your
+      machine has to be. So if you here &#34;clicks&#34;, or &#34;drops&#34;
+      in audio output that are not related to your sample-material you will
+      have to increase the buffer size. On the other hand if you believe
+      terminatorX does not react fast enough you have to decrease this
+      parameter. The default value is 8, but as my machine handles 7 nicely
+      (running with root privileges for realtime scheduling) I use 7.</para>
+    </sect2>
+
+    <sect2 id="MOUSEINPUTSETUP">
+      <title>Mouse/Input Setup</title>
+
+      <para>Between rendering and outputing these blocks terminatorX checks
+      for mouse motion. The problem with mice is: they don&#39;t report when
+      they have stopped. This is why terminatorX assumes your mouse has
+      stopped if there is no motion reported for certain amount of
+      render/output-cycles. This value is configurable via the
+      <emphasis>Stop-sense-cycles</emphasis> option. If you decrease your
+      buffsize of course you shorten the cycle time as well, therefore if you
+      here strange stop/run behaviour of the audio ouput while scratching
+      after you decreased the buffersize you might have to increase the
+      stop-sense value too.</para>
 
       <para>Xinput Device: <emphasis>WARNING:</emphasis> Use this option
-       *only* if you want to use an input device other than your
-       default-mouse for scratching. Selecting your default pointer
-       will cause terminatorX to crash. See the "Using a turntable"
-       section on the terminatorX homepage for
-       details.</para></section>
-
-    <section id="GUISETUP"><title>GUI Setup</title>
-      <para>With <emphasis>Update Idle</emphasis> / <emphasis>Update
-         Delay</emphasis> you can configure GUI resposivness: Higher
-       <emphasis>Update Idle</emphasis> will cause the wav-display
-       (position display) and flash-widgets to update less
-       often. Higher <emphasis>Update Delay</emphasis> values will
-       cause the parameter widgets to update less
-       often.</para></section>
-
-    <section id="SOUNDFILEEDITOR"><title>Soundfile-Editor integration</title>
+      *only* if you want to use an input device other than your default-mouse
+      for scratching. Selecting your default pointer will cause terminatorX to
+      crash. See the &#34;Using a turntable&#34; section on the terminatorX
+      homepage for details.</para>
+    </sect2>
+
+    <sect2 id="GUISETUP">
+      <title>GUI Setup</title>
+
+      <para>With <emphasis>Update Idle</emphasis> / <emphasis>Update Delay</emphasis>
+      you can configure GUI resposivness: Higher <emphasis>Update Idle</emphasis>
+      will cause the wav-display (position display) and flash-widgets to
+      update less often. Higher <emphasis>Update Delay</emphasis> values will
+      cause the parameter widgets to update less often.</para>
+    </sect2>
+
+    <sect2 id="SOUNDFILEEDITOR">
+      <title>Soundfile-Editor integration</title>
+
       <para>You can now enter the soundfile editor of your choice in the
-       "Soundfile editor" field. This editor will be started when
-       clicking the <emphasis>Edit</emphasis>-button in the  main panel
-       of the vtt-gui. If you enter for example "myeditor" terminatorX
-       will run "myeditor
-       sample_in_vtt.wav".</para></section></section>
-
-  <section id="CONTACT"><title>Contact / Download</title>
-    <para>Find out more about terminatorX at it's <ulink url="http://www.terminatorX.cx">homepage</ulink>.</para>
-    <para>Send me comments, bug-reports, patches or scratches (see
-      scratches section on the terminatorX homepage) at:
-      <email>alkoit00@fht-esslingen.de</email></para></section>
-</article>
+      &#34;Soundfile editor&#34; field. This editor will be started when
+      clicking the <emphasis>Edit</emphasis>-button in the main panel of the
+      vtt-gui. If you enter for example &#34;myeditor&#34; terminatorX will
+      run &#34;myeditor sample_in_vtt.wav&#34;.</para>
+    </sect2>
+  </sect1>
+
+  <sect1 id="CONTACT">
+    <title>Contact / Download</title>
 
+    <para>Find out more about terminatorX at it&#39;s <ulink
+    url="http://www.terminatorX.cx">homepage</ulink>.</para>
 
+    <para>Send me comments, bug-reports, patches or scratches (see scratches
+    section on the terminatorX homepage) at: <email>alex@lisas.de</email></para>
+  </sect1>
 
+   &GFDL;
+</article>
index 8aa2d25c5c000e935d883e425458b752ce90519d..700fc8ee9f04e937947d054ac4138d74960db995 100644 (file)
@@ -21,25 +21,25 @@ GtkSignalFunc tX_extdial :: f_adjustment(GtkWidget *w, tX_extdial *ed)
        return NULL;    
 }
 
-tX_extdial :: tX_extdial(const char *l, GtkAdjustment *a)
+tX_extdial :: tX_extdial(const char *l, GtkAdjustment *a, bool text_below)
 {
        adj=a;
        fval=adj->value;
        f2s();
-       label=gtk_label_new(l);
+       if (l) label=gtk_label_new(l);
        dial=gtk_tx_dial_new(adj);
        entry=gtk_entry_new_with_max_length(5);
        gtk_entry_set_text(GTK_ENTRY(entry), sval);
        ignore_adj=0;
        
-       mainbox=gtk_vbox_new(FALSE, 0);
+       mainbox=gtk_vbox_new(FALSE, text_below ? 5 : 0);
        subbox=gtk_hbox_new(TRUE, 0);
        gtk_box_pack_start(GTK_BOX(subbox), dial, WID_FIX);
-       gtk_box_pack_start(GTK_BOX(subbox), entry, WID_DYN);
        gtk_box_pack_start(GTK_BOX(mainbox), subbox, WID_FIX);
-       gtk_box_pack_start(GTK_BOX(mainbox), label, WID_FIX);
+       gtk_box_pack_start(GTK_BOX(text_below ? mainbox : subbox), entry, WID_DYN);
+       if (l) gtk_box_pack_start(GTK_BOX(mainbox), label, WID_FIX);
        
-       gtk_widget_show(label);
+       if (l) gtk_widget_show(label);
        gtk_widget_show(entry);
        gtk_entry_set_width_chars(GTK_ENTRY(entry), 4);
        gtk_widget_show(dial);
index 5e804d0a8974c29d3cf7ee99f1f1da794c38d744..ea5a76e85a1fe5ffc8e2fe4a2d7ed37014959beb 100644 (file)
@@ -22,7 +22,7 @@ class tX_extdial
        void f2s() { sprintf(sval, "%3f", fval); sval[4]=0; /* printf("f2s(): s:%s, f%f\n", sval, fval); */ };
        
        public:
-       tX_extdial(const char *l, GtkAdjustment *a);
+       tX_extdial(const char *l, GtkAdjustment *a, bool text_below=false);
        ~tX_extdial();
        GtkWidget *get_widget() { return mainbox; };
        GtkWidget *get_dial() { return dial; }
index 4d995c189a1d9de21d1d364401e9710650aa3402..953caa3fe5f53bc9ed6c7a90e4894d69843ee603 100644 (file)
@@ -799,25 +799,18 @@ void sequencer_move(GtkWidget *wid, void *d)
        gtk_widget_show(dummy);\
 
 #define add_sep2();    dummy=gtk_hseparator_new ();\
-       gtk_box_pack_end(GTK_BOX(smaller_box), dummy, WID_FIX);\
+       gtk_box_pack_end(GTK_BOX(status_box), dummy, WID_FIX);\
        gtk_widget_show(dummy);\
 
 void fullscreen_toggle(GtkCheckMenuItem *item, gpointer data);
+void display_help();
 
 void create_master_menu() {
        GtkWidget *menu_item;
        GtkWidget *sub_menu;
        GtkAccelGroup* accel_group=gtk_accel_group_new();
        gtk_window_add_accel_group(GTK_WINDOW(main_window), accel_group);
-      /*gtk_signal_connect (GTK_OBJECT (dummy), "drag_data_received",
-        gtk_signal_connect(GTK_OBJECT(dummy), "clicked", GtkSignalFunc(new_table), NULL);       
-        gtk_signal_connect(GTK_OBJECT(dummy), "clicked", GtkSignalFunc(load_tables), NULL);     
-        gtk_signal_connect (GTK_OBJECT (dummy), "drag_data_received",
-        gtk_signal_connect(GTK_OBJECT(dummy), "clicked", GtkSignalFunc(save_tables), NULL);     
-        gtk_signal_connect (GTK_OBJECT(dummy), "clicked", (GtkSignalFunc) display_options, NULL);
-        gtk_signal_connect (GTK_OBJECT(dummy), "clicked", (GtkSignalFunc) mplcfitx, NULL);      
-        gtk_signal_connect (GTK_OBJECT(dummy), "clicked", (GtkSignalFunc) quit, NULL);
-*/
+
        /* FILE */
        menu_item = gtk_menu_item_new_with_mnemonic ("_File");
        gtk_widget_show (menu_item);
@@ -900,14 +893,31 @@ void create_master_menu() {
        menu_item = gtk_menu_item_new_with_mnemonic ("_Help");
        gtk_widget_show (menu_item);
        gtk_container_add (GTK_CONTAINER (main_menubar), menu_item);
-
+       gtk_menu_item_set_right_justified(GTK_MENU_ITEM(menu_item), TRUE);
+       
        sub_menu = gtk_menu_new ();
        gtk_menu_item_set_submenu (GTK_MENU_ITEM (menu_item), sub_menu);
 
+       menu_item = gtk_menu_item_new_with_mnemonic ("_Contents");
+       gtk_widget_show (menu_item);
+       gtk_container_add (GTK_CONTAINER (sub_menu), menu_item);
+       g_signal_connect(menu_item, "activate", (GCallback) display_help, NULL);
+       gtk_widget_add_accelerator (menu_item, "activate", accel_group, GDK_F1, (GdkModifierType) 0, GTK_ACCEL_VISIBLE);
+
        menu_item = gtk_menu_item_new_with_mnemonic ("_About");
        gtk_widget_show (menu_item);
        gtk_container_add (GTK_CONTAINER (sub_menu), menu_item);
        g_signal_connect(menu_item, "activate", (GCallback) mplcfitx, NULL);
+       
+       menu_item = gtk_menu_item_new ();
+       gtk_widget_show (menu_item);
+       gtk_container_add (GTK_CONTAINER (sub_menu), menu_item);
+       gtk_widget_set_sensitive (menu_item, FALSE);
+
+       menu_item = gtk_menu_item_new_with_mnemonic ("_Visit terminatorX.cx");
+       gtk_widget_show (menu_item);
+       gtk_container_add (GTK_CONTAINER (sub_menu), menu_item);
+       //g_signal_connect(menu_item, "activate", (GCallback) mplcfitx, NULL);
 }
 
 void create_mastergui(int x, int y)
@@ -920,8 +930,8 @@ void create_mastergui(int x, int y)
        GtkWidget *sequencer_box;
        GtkAdjustment *dumadj;
        GtkWidget *dummy;
-       GtkWidget *small_box;
-       GtkWidget *smaller_box;
+       GtkWidget *master_vol_box;
+       GtkWidget *status_box;
        
        static GtkTargetEntry drop_types [] = {
                { "text/uri-list", 0, 0}
@@ -998,20 +1008,6 @@ void create_mastergui(int x, int y)
        gui_set_tooltip(dummy, "Record the audio the terminatorX' audio engine renders. You will be prompted to enter a name for the target wav-file.");
        gtk_widget_show(dummy);
        
-       dummy=gtk_label_new("Pitch:");
-       gtk_box_pack_start(GTK_BOX(control_box), dummy, WID_FIX);
-       gtk_widget_show(dummy);
-
-       dumadj=(GtkAdjustment*) gtk_adjustment_new(globals.pitch, -3, 3, 0.001, 0.001, 0.01);
-       pitch_adj=dumadj;
-       connect_adj(dumadj, master_pitch_changed, NULL);        
-       dummy=gtk_hscale_new(dumadj);
-       gtk_scale_set_digits(GTK_SCALE(dummy), 2);
-       gtk_scale_set_value_pos(GTK_SCALE(dummy), GTK_POS_LEFT);
-       gtk_box_pack_start(GTK_BOX(control_box), dummy, WID_DYN);
-       gui_set_tooltip(dummy, "Use this scale to adjust the master pitch (affecting *all* turntables).");
-       gtk_widget_show(dummy);
-
        dummy=tx_xpm_label_box(TX_ICON_SEQUENCER, "Sequencer");
        gtk_box_pack_start(GTK_BOX(sequencer_box), dummy, WID_FIX);
        gtk_widget_show(dummy);
@@ -1090,86 +1086,90 @@ void create_mastergui(int x, int y)
        right_hbox=gtk_vbox_new(FALSE, 5);
        gtk_box_pack_start(GTK_BOX(main_vbox), right_hbox, WID_FIX);
        gtk_widget_show(right_hbox);
-/*     
-       dummy=gtk_button_new_with_label("Add Turntable");
-       AddTable=dummy; 
-       gtk_box_pack_start(GTK_BOX(right_hbox), dummy, WID_FIX);
-       gui_set_tooltip(dummy, "Click this button to add a new turntable to the current set.");
-       gtk_widget_show(dummy);
 
-       gtk_drag_dest_set (GTK_WIDGET (dummy), (GtkDestDefaults) (GTK_DEST_DEFAULT_MOTION |GTK_DEST_DEFAULT_HIGHLIGHT |GTK_DEST_DEFAULT_DROP),
-                       drop_types, n_drop_types,
-                       GDK_ACTION_COPY);
-                                               
-       gtk_signal_connect (GTK_OBJECT (dummy), "drag_data_received",
-                       GTK_SIGNAL_FUNC(drop_new_table), NULL);
+       /* Master */
        
-       gtk_signal_connect(GTK_OBJECT(dummy), "clicked", GtkSignalFunc(new_table), NULL);       
-
-       dummy=gtk_button_new_with_label("Load Set");
-       LoadSet=dummy;
+       dummy=gtk_label_new("Master");
+       gtk_misc_set_alignment(GTK_MISC(dummy), 0.5, 0.5);
        gtk_box_pack_start(GTK_BOX(right_hbox), dummy, WID_FIX);
-       gtk_widget_show(dummy);
-       gui_set_tooltip(dummy, "Click to load a previously saved terminatorX-set-file. As an alternative you can drop a set file over this button.");
-       gtk_signal_connect(GTK_OBJECT(dummy), "clicked", GtkSignalFunc(load_tables), NULL);     
-
-       gtk_drag_dest_set (GTK_WIDGET (dummy), (GtkDestDefaults) (GTK_DEST_DEFAULT_MOTION |GTK_DEST_DEFAULT_HIGHLIGHT |GTK_DEST_DEFAULT_DROP),
-                       drop_types, n_drop_types,
-                       GDK_ACTION_COPY);
-                                               
-       gtk_signal_connect (GTK_OBJECT (dummy), "drag_data_received",
-                       GTK_SIGNAL_FUNC(drop_set), NULL);
-       
-       dummy=gtk_button_new_with_label("Save Set");
-       SaveSet=dummy;
+       gtk_widget_show(dummy); 
+
+       dummy=gtk_hseparator_new();
        gtk_box_pack_start(GTK_BOX(right_hbox), dummy, WID_FIX);
        gtk_widget_show(dummy);
-       gui_set_tooltip(dummy, "Click here to save the current set.");
-       gtk_signal_connect(GTK_OBJECT(dummy), "clicked", GtkSignalFunc(save_tables), NULL);     
 
-       add_sep();
+        /* Pitch */
+        
+       /*dummy=gtk_label_new("Pitch:");
+       gtk_box_pack_start(GTK_BOX(control_box), dummy, WID_FIX);
+       gtk_widget_show(dummy);*/
+
+       dumadj=(GtkAdjustment*) gtk_adjustment_new(globals.pitch, -3, 3, 0.001, 0.001, 0.01);
+       pitch_adj=dumadj;
+       connect_adj(dumadj, master_pitch_changed, NULL);
        
-       dummy=gtk_button_new_with_label("Options");
+       tX_extdial *pdial=new tX_extdial("Pitch", pitch_adj, true);
+       gtk_box_pack_start(GTK_BOX(right_hbox), pdial->get_widget(), WID_FIX);
+       gui_set_tooltip(pdial->get_entry(), "Use this dial to adjust the master pitch (affecting *all* turntables).");
+       
+/*     dummy=gtk_hscale_new(dumadj);
+       gtk_scale_set_digits(GTK_SCALE(dummy), 2);
+       gtk_scale_set_value_pos(GTK_SCALE(dummy), GTK_POS_LEFT);
+       gtk_box_pack_start(GTK_BOX(control_box), dummy, WID_DYN);
+       gui_set_tooltip(dummy, "Use this scale to adjust the master pitch (affecting *all* turntables).");
+       gtk_widget_show(dummy);
+*/
+       dummy=gtk_hseparator_new();
        gtk_box_pack_start(GTK_BOX(right_hbox), dummy, WID_FIX);
        gtk_widget_show(dummy);
-       gui_set_tooltip(dummy, "Click here to configure terminatorX.");
-       gtk_signal_connect (GTK_OBJECT(dummy), "clicked", (GtkSignalFunc) display_options, NULL);
+       
+       /* Volume */
+       master_vol_box=gtk_hbox_new(FALSE, 2);
+       gtk_box_pack_start(GTK_BOX(right_hbox), master_vol_box, WID_DYN);
+       gtk_widget_show(master_vol_box);        
+       
+       dumadj=(GtkAdjustment*) gtk_adjustment_new(2.0-globals.volume, 0, 2, 0.01, 0.05, 0.005);
+       volume_adj=dumadj;
 
-       dummy=gtk_button_new_with_label("About/Legal");
+       connect_adj(dumadj, master_volume_changed, NULL);       
+       dummy=gtk_vscale_new(dumadj);
+       gtk_scale_set_draw_value(GTK_SCALE(dummy), False);
+       gtk_box_pack_end(GTK_BOX(master_vol_box), dummy, WID_FIX);
+       gtk_widget_show(dummy); 
+       gui_set_tooltip(dummy, "Adjust the master volume. This parameter will effect *all* turntables in the set.");
+       
+#ifdef USE_FLASH       
+       main_flash_r=gtk_tx_flash_new();
+       gtk_box_pack_end(GTK_BOX(master_vol_box), main_flash_r, WID_DYN);
+       gtk_widget_show(main_flash_r);
+
+       main_flash_l=gtk_tx_flash_new();
+       gtk_box_pack_end(GTK_BOX(master_vol_box), main_flash_l, WID_DYN);
+       gtk_widget_show(main_flash_l);
+#endif 
+       dummy=gtk_label_new("Volume");
+       gtk_misc_set_alignment(GTK_MISC(dummy), 0.5, 0.5);
        gtk_box_pack_start(GTK_BOX(right_hbox), dummy, WID_FIX);
        gtk_widget_show(dummy);
-       gui_set_tooltip(dummy, "Click here to read the license and to get some information about this binary.");
-       gtk_signal_connect (GTK_OBJECT(dummy), "clicked", (GtkSignalFunc) mplcfitx, NULL);      
 
-       dummy=gtk_button_new_with_label("Quit");
+       /* STATUS BOX */ 
+       dummy=gtk_hseparator_new();
        gtk_box_pack_start(GTK_BOX(right_hbox), dummy, WID_FIX);
        gtk_widget_show(dummy);
-       gui_set_tooltip(dummy, "Click here to exit terminatorX.");
-       gtk_signal_connect (GTK_OBJECT(dummy), "clicked", (GtkSignalFunc) quit, NULL);
-
-       add_sep();              
-*/
-       small_box=gtk_hbox_new(FALSE, 5);
-       gtk_box_pack_start(GTK_BOX(right_hbox), small_box, WID_DYN);
-       gtk_widget_show(small_box);
        
-       smaller_box=gtk_vbox_new(FALSE, 0);
-       gtk_box_pack_start(GTK_BOX(small_box), smaller_box, WID_FIX);
-       gtk_widget_show(smaller_box);
+       status_box=gtk_vbox_new(FALSE, 0);
+       gtk_box_pack_start(GTK_BOX(right_hbox), status_box, WID_FIX);
+       gtk_widget_show(status_box);
        
-       dummy = tx_pixmap_widget(TX_ICON_LOGO);
-       gtk_box_pack_start(GTK_BOX(smaller_box), dummy, WID_FIX);
-       gtk_widget_show( dummy );
-
        dummy=gtk_label_new("0");
        used_mem=dummy;
        gtk_misc_set_alignment(GTK_MISC(dummy), 1, 0.5);
-       gtk_box_pack_end(GTK_BOX(smaller_box), dummy, WID_FIX);
+       gtk_box_pack_end(GTK_BOX(status_box), dummy, WID_FIX);
        gtk_widget_show(dummy);
 
        dummy=gtk_label_new("Mem/kB:");
        gtk_misc_set_alignment(GTK_MISC(dummy), 0, 0.5);
-       gtk_box_pack_end(GTK_BOX(smaller_box), dummy, WID_FIX);
+       gtk_box_pack_end(GTK_BOX(status_box), dummy, WID_FIX);
        gtk_widget_show(dummy);
        
        add_sep2();
@@ -1177,52 +1177,35 @@ void create_mastergui(int x, int y)
        dummy=gtk_label_new("1");
        no_of_vtts=dummy;
        gtk_misc_set_alignment(GTK_MISC(dummy), 1, 0.5);
-       gtk_box_pack_end(GTK_BOX(smaller_box), dummy, WID_FIX);
+       gtk_box_pack_end(GTK_BOX(status_box), dummy, WID_FIX);
        gtk_widget_show(dummy);
 
        dummy=gtk_label_new("Vtts:");
        gtk_misc_set_alignment(GTK_MISC(dummy), 0, 0.5);
-       gtk_box_pack_end(GTK_BOX(smaller_box), dummy, WID_FIX);
+       gtk_box_pack_end(GTK_BOX(status_box), dummy, WID_FIX);
        gtk_widget_show(dummy);
 
        add_sep2();
 
        dummy=gtk_label_new(VERSION);
        gtk_misc_set_alignment(GTK_MISC(dummy), 1, 0.5);
-       gtk_box_pack_end(GTK_BOX(smaller_box), dummy, WID_FIX);
+       gtk_box_pack_end(GTK_BOX(status_box), dummy, WID_FIX);
        gtk_widget_show(dummy);
 
        dummy=gtk_label_new("Release:");
        gtk_misc_set_alignment(GTK_MISC(dummy), 0, 0.5);
-       gtk_box_pack_end(GTK_BOX(smaller_box), dummy, WID_FIX);
+       gtk_box_pack_end(GTK_BOX(status_box), dummy, WID_FIX);
        gtk_widget_show(dummy);
        
        add_sep2();
 
        dummy=gtk_label_new("Status:");
        gtk_misc_set_alignment(GTK_MISC(dummy), 0.5, 0.5);
-       gtk_box_pack_end(GTK_BOX(smaller_box), dummy, WID_FIX);
+       gtk_box_pack_end(GTK_BOX(status_box), dummy, WID_FIX);
        gtk_widget_show(dummy);
        
-       dumadj=(GtkAdjustment*) gtk_adjustment_new(2.0-globals.volume, 0, 2, 0.01, 0.05, 0.005);
-       volume_adj=dumadj;
-
-       connect_adj(dumadj, master_volume_changed, NULL);       
-       dummy=gtk_vscale_new(dumadj);
-       gtk_scale_set_draw_value(GTK_SCALE(dummy), False);
-       gtk_box_pack_end(GTK_BOX(small_box), dummy, WID_DYN);
-       gtk_widget_show(dummy); 
-       gui_set_tooltip(dummy, "Adjust the master volume. This parameter will effect *all* turntables in the set.");
+       /* END GUI */
        
-#ifdef USE_FLASH       
-       main_flash_r=gtk_tx_flash_new();
-       gtk_box_pack_end(GTK_BOX(small_box), main_flash_r, WID_DYN);
-       gtk_widget_show(main_flash_r);
-
-       main_flash_l=gtk_tx_flash_new();
-       gtk_box_pack_end(GTK_BOX(small_box), main_flash_l, WID_DYN);
-       gtk_widget_show(main_flash_l);
-#endif 
        gtk_window_set_default_size(GTK_WINDOW(main_window), x, y);     
        gtk_widget_set_sensitive(grab_button, 0);
 
@@ -1360,3 +1343,18 @@ void display_mastergui()
        top=gtk_widget_get_toplevel(main_window);
        xwindow=GDK_WINDOW_XWINDOW(top->window);
 }
+
+void display_help() {
+       pid_t child;
+       
+       child=fork();
+       
+       if (child==0) {
+               // child
+               execlp("gnome-help","gnome-help","ghelp://home/alex/devel/terminatorX/terminatorX/doc/terminatorX-manual/C/terminatorX-manual.xml", NULL);
+               //tx_note("Couldn't run the gnome-help command (alias \"yelp\") to display the terminatorX manual. Please ensure that \"yelp\" is installed.", true);
+               exit(-1);
+       } else if (child==-1) {
+               tx_note("System error: couldn't fork() to run the help process.", true);
+       }
+}