<?xml version="1.0"?>
<!-- NB NB NB: Don't edit solfege.xml, edit solfege.xml.in, since
     the first is generated from the second file.
-->
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" 
"http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [
  <!ENTITY ldquo "'">
  <!ENTITY rsquo "'">
  <!ENTITY rdquo "'">
  <!ENTITY rsquo "'">
  <!ENTITY appversion "@VERSION@">
  <!ENTITY app "<application>GNU Solfege</application>">
  <!-- 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 app entity to specify the name of the application. -->
]>
<book id="index" lang="en">

  <bookinfo>
    <title>&app; &appversion; User Manual</title>
    <copyright>
      <year>2005</year>
      <holder>Tom Eykens</holder>
    </copyright>
    <copyright> 
      <year>2000</year> 
      <year>2001</year> 
      <year>2002</year> 
      <year>2003</year> 
      <year>2004</year> 
      <year>2005</year> 
      <year>2006</year>
      <year>2007</year>
      <year>2008</year>
      <holder>Tom Cato Amundsen</holder> 
    </copyright> 
    <authorgroup>
      <author>
        <firstname>Tom Cato</firstname>
        <surname>Amundsen</surname>
        <affiliation>
            <address>
                <email>tca@gnu.org</email>
            </address>
        </affiliation>
      </author>
    </authorgroup>
    <legalnotice id="legalnotice">
    <para>
      Permission is granted to copy, distribute and/or modify this document
      under the terms of the GNU General Public License as published by the
      Free Software Foundation; either version 3 of the License, or (at your
      option) any later version. The full text of the License is available in
      <xref linkend='gpl'/>.</para>
    </legalnotice>
  </bookinfo>


<chapter id="solfege-intro">
    <title>Introduction</title>

<sect1 id='about-the-manual'>
<title>Welcome to GNU Solfege</title>
<para>Solfege is a <ulink
url='http://www.gnu.org/philosophy/free-sw.html'>free</ulink> eartraining
program. The program is
part of the <ulink url='http://www.gnu.org'>GNU Project</ulink>. Check <xref linkend='online-resources'/> for info on mailinglists and where to get the
latest version of Solfege.</para>

<para>One of the ideas of this program is that you can extend the program
without having to dig into the source code. If you want to practise some
special chords or want to practise dictation with some music not included, you
can write <link linkend='extending-solfege'>lesson files</link> and put them
into a
<filename>lessonfiles/</filename> subdirectory in your
<filename>$HOME</filename> directory. If you create good lesson files, you
really should consider contributing them by sending them to the
<link linkend='mailing-lists'>mailinglist</link> so
I can add them to the next version of this program.</para>
</sect1>

<xi:include
    xmlns:xi="http://www.w3.org/2001/XInclude" href="bug-reporting.xml"/>
<xi:include
    xmlns:xi="http://www.w3.org/2001/XInclude" href="online-resources.xml"/>
<xi:include
    xmlns:xi="http://www.w3.org/2001/XInclude" href="preferences-window.xml"/>
<xi:include
    xmlns:xi="http://www.w3.org/2001/XInclude" href="trainingset-editor.xml"/>
<xi:include
    xmlns:xi="http://www.w3.org/2001/XInclude" href="ear-training-test-printout-editor.xml"/>
</chapter>
<chapter id="solfege-exercise-helps">
<title>Help sections for the exercises</title>
<!-- Dummy sect1 to make sure harmonicinterval.xml generates a separate page. 
-->
<sect1 id='dummy-sect'><title></title><para></para></sect1>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" 
 href="harmonicinterval.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
 href="melodicinterval.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
 href="singinterval.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
 href="idbyname-chords.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
 href="idbyname-cadences.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
 href="idproperty.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
 href="singchord.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
 href="rhythm.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
 href="rhythmtapping2.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
 href="dictation.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
 href="scales.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
 href="idbyname-intonation.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
 href="idtone.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
 href="identifybpm.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
 href="twelvetone.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
 href="nameinterval.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
 href="elembuilder-harmonic-progressions.xml"/>
</chapter>
<xi:include
    xmlns:xi="http://www.w3.org/2001/XInclude" href="../C/music-theory.xml"/>
<xi:include
    xmlns:xi="http://www.w3.org/2001/XInclude" href="../C/lessonfiles.xml"/>
<xi:include
    xmlns:xi="http://www.w3.org/2001/XInclude" href="../C/gpl.xml"/>
</book>

