<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.5-Based Variant V1.1//EN" "dtd/kdedbx45.dtd" [
  <!ENTITY % addindex "IGNORE">
  <!ENTITY % English "INCLUDE"><!-- change language only here -->
]>

<book id="kmouth" lang="&language;">
<bookinfo>
  <title>The &kmouth; Handbook</title>

  <authorgroup>
    <author>
      <firstname>Gunnar</firstname>
      <surname>Schmi Dt</surname>
      <affiliation>
        <address><email>gunnar@schmi-dt.de</email></address>
      </affiliation>
    </author>
  <!-- TRANS:ROLES_OF_TRANSLATORS -->
  </authorgroup>


  <copyright>
    <year>2002</year><year>2003</year>
    <holder>Gunnar Schmi Dt</holder>
  </copyright>
  <!-- Translators: put here the copyright notice of the translation -->
  <legalnotice>&FDLNotice;</legalnotice>


  <date>2022-03-18</date>
  <releaseinfo>1.2.0 (KDE Gear 22.04)</releaseinfo>

  <abstract>
    <para>
      &kmouth; is an application that enables persons that cannot speak to let their
      computers speak.
    </para>
  </abstract>

  <keywordset>
    <keyword>KDE</keyword>
    <keyword>kdeaccesibility</keyword>
    <keyword>KMouth</keyword>
    <keyword>text-to-speech conversion</keyword>
    <keyword>mutual persons</keyword>
  </keywordset>
</bookinfo>

<chapter id="introduction">
  <title>Introduction</title>

  <para>
    &kmouth; is a program that enables persons that cannot speak to let their
    computers speak. It includes a history of spoken sentences from which the
    user can select sentences to be re-spoken.
  </para>
  <para>
    Note that &kmouth; does not include any speech synthesizers. Instead it requires
    a speech synthesizer installed in the system.
  </para>
</chapter>

<chapter id="using-kmouth">
  <title>Using &kmouth;</title>
  <sect1 id="Wizard">
    <title>The First Time Setup</title>
    <para>
      During the first use of &kmouth;, a wizard is displayed in which you
      can configure it.
    </para>
    <para>
      <screenshot>
        <screeninfo>Text-to-Speech Configuration</screeninfo>
        <mediaobject>
          <imageobject>
            <imagedata fileref="kmouthwizard1.png" format="PNG"/>
          </imageobject>
          <textobject>
            <phrase>Text-to-Speech Configuration</phrase>
          </textobject>
        </mediaobject>
      </screenshot>
    </para>
    <para>
      With the first page of the wizard you specify
      the engine and voice that shall be used for the text-to-speech conversion.
      For more details look into the <link linkend="tts-config">description
      of the configuration dialog.</link>
    </para>
    <para>
      <screenshot>
        <screeninfo>Word Completion</screeninfo>
        <mediaobject>
          <imageobject>
            <imagedata fileref="kmouthwizard3.png" format="PNG"/>
          </imageobject>
          <textobject>
            <phrase>Word Completion</phrase>
          </textobject>
        </mediaobject>
      </screenshot>
    </para>
    <para>
      With the third page you define the dictionary
      for a word completion. &kmouth; will parse the &kde; documentation of
      the chosen language in order to detect the regularity of individual
      words. Optionally you can compare the word list to an OpenOffice.org
      dictionary in order to only add correctly spelled words to the word
      completion.
    </para>
  </sect1>
  <sect1 id="main-window">
    <title>The Main Window</title>
    <para>
      The main window of &kmouth; is fairly simple. It consists basically of an
      edit field into which you type your sentences (the lower white field in
      the screen shot) and a history of spoken sentences (the upper white field
      in the screen shot).
    </para>
    <para>
      <screenshot>
        <screeninfo>The main window of &kmouth;</screeninfo>
        <mediaobject>
          <imageobject>
            <imagedata fileref="kmouthmain.png" format="PNG"/>
          </imageobject>
          <textobject>
            <phrase>The main window of &kmouth;</phrase>
          </textobject>
        </mediaobject>
      </screenshot>
    </para>
    <para>
      Assuming that you have correctly <link linkend="config-dialog">configured
      &kmouth;</link> you can use the edit field for entering sentences you
      want to hear. Once a sentence got spoken it will be appended to the
      history. From the history you can select sentences to be re-spoken.
    </para>
    <para>
      From the phrase books (located in the line below the tool bar) you can
      select often used phrases.
    </para>
  </sect1>
  <sect1 id="config-dialog">
    <title>The Configuration Dialog</title>
    <para>
      By using the menu entry
      <menuchoice>
        <guimenu>Settings</guimenu><guimenuitem>Configure &kmouth;...</guimenuitem>
      </menuchoice>
      you open the configuration dialog of &kmouth;. This dialog consists of
      the pages <guilabel>General Options</guilabel> with the two tabs <guilabel>Preferences</guilabel>
      and <guilabel>Text-to-Speech</guilabel> and the page <guilabel>Word Completion</guilabel>.
    </para>
    <sect2 id="preferences">
      <title>The Preferences tab</title>
      <para>
        <screenshot>
          <screeninfo>The <guilabel>Preferences</guilabel> tab</screeninfo>
          <mediaobject>
            <imageobject>
              <imagedata fileref="kmouthcpref.png" format="PNG"/>
            </imageobject>
            <textobject>
              <phrase>Screen shot</phrase>
            </textobject>
          </mediaobject>
        </screenshot>
      </para>
      <para>
        The <guilabel>Preferences</guilabel> tab contains options that alter the behavior of
        &kmouth; in certain situations.
      </para>
      <para>
        With the first combo box <guilabel>Selection of phrases in the phrase book</guilabel>
        you specify which action is triggered by typing the shortcut of a
        phrase or by selecting a phrase in the <guimenu>Phrase Book</guimenu>
        menu or in the phrase book bar.
      </para>
      <para>
        By selecting <guilabel>Speak Immediately</guilabel> the
        selected phrase gets immediately spoken and is entered into
        the history. If you select <guilabel>Insert Into Edit
        Field</guilabel> the selected phrase is just inserted into the
        edit field.
      </para>
      <para>
        With the second combo box, <guilabel>Closing the phrase book
        edit window</guilabel>, you specify whether the phrase book
        gets saved if you just close the phrase book edit window.
      </para>
      <para>
        By selecting <guilabel>Save Phrase Book</guilabel> the phrase
        book gets saved. If you select <guilabel>Discard
        changes</guilabel> the changes are discarded and the phrase
        book is not saved. If you select <guilabel>Ask Whether to
        Save</guilabel> &kmouth; will ask you whether it shall save
        the phrase book.
      </para>
    </sect2>
    <sect2 id="tts-config">
      <title>The Text-to-Speech tab</title>
      <para>
        <screenshot>
          <screeninfo>The <guilabel>Text-to-Speech</guilabel> tab</screeninfo>
          <mediaobject>
            <imageobject>
              <imagedata fileref="kmouthctts.png" format="PNG"/>
            </imageobject>
            <textobject>
              <phrase>Screen shot</phrase>
            </textobject>
          </mediaobject>
        </screenshot>
      </para>
      <para>
        By selecting <guilabel>Use default speech system</guilabel> you tell &kmouth;
        first to try to use the system speech service prior to calling the speech
        synthesizer directly. If this succeeds the other configuration entries on
        this tab are ignored. The system speech service is a &Qt; library which
        wraps speech-dispatcher on &Linux;, and native speech systems on other platforms.
        On a Debian based system you need the packages speech-dispatcher, libqt5texttospeech5
        and one of the speech-dispatcher modules, usually <application>espeak</application>.
        <note><para>Use the commandline tool <command>spd-conf</command> (Debian package python3-speechd)
        to adjust settings like rate, pitch, volume, voice type and language &etc; for the default speech system.
        Additionally <command>spd-conf</command> will let you choose between all installed
        speech-dispatcher modules, &ie; <application>espeak</application>,
        <application>festival</application>, <application>flite</application>,
        <application>mbrola</application> &etc;
        </para></note>
      </para>
      <para>
          It is also possible to select the <guilabel>Engine</guilabel> and <guilabel>Voice</guilabel> for the speech system.
      </para>
      <para>
        Should the <guilabel>Use default speech system</guilabel> item is not selected you can enter the command
        for calling the speech synthesize into the edit field of the <guilabel>Alternative</guilabel> panel. With the combo box below the edit
        field you specify the character encoding that is used for passing the
        text to the speech synthesizer.
      </para>
      <para>
        &kmouth; knows two ways of passing the text: If the command expects the
        text as standard input you select the check box.
      </para>
      <para>
        The other way is to pass the text as a parameter:
        Before calling the command &kmouth; replaces certain placeholders with
        actual content:
        <informaltable frame="topbot">
         <tgroup cols="2">
          <thead>
          <row><entry>Placeholder</entry><entry>Replaced with</entry></row>
          </thead>
            <tbody>
              <row><entry><token>%t</token></entry>
                   <entry>The actual text that should be spoken</entry>
              </row>
              <row><entry><token>%f</token></entry>
                   <entry>The name of a temporary file that contains the text
                          that should be spoken</entry>
              </row>
              <row><entry><token>%l</token></entry>
                   <entry>The language code associated with the current word completion
                          dictionary</entry>
              </row>
              <row><entry><token>%%</token></entry><entry>A percent sign</entry></row>
           </tbody>
          </tgroup>
        </informaltable>
      </para>
      <para>
        Of course the command for speaking texts is dependent on which speech
        synthesizer you use. Please look into the documentation of your speech
        synthesizer for the command for speaking texts.<!--FIXME comment until appendix tts is up to date You can find examples
        for the command in the <link linkend="tts">appendix</link>.-->
      </para>
    </sect2>
    <sect2 id="completion-config">
      <title>The Word Completion page</title>
      <para>
        <screenshot>
          <screeninfo>The <guilabel>Word Completion</guilabel> page</screeninfo>
          <mediaobject>
            <imageobject>
              <imagedata fileref="kmouthcwcp.png" format="PNG"/>
            </imageobject>
            <textobject>
              <phrase>Screen shot</phrase>
            </textobject>
          </mediaobject>
        </screenshot>
      </para>
      <para>
        The <guilabel>Word Completion</guilabel> page contains a list
        of dictionaries used for the word completion. (&kmouth; will
        display a combo box next to the edit field in the main window
        if this list contains more than one dictionary. You can use this
        combo box in order to select the dictionary that actually gets
        used for the word completion.)
      </para>
      <para>
        With the buttons on the right side of the page you can add and
        delete dictionaries, change the order of the dictionaries or export
        dictionaries to a file. With the edit field and the combo box below
        the list you can change the name and the language associated with
        the dictionary.
      </para>
      <para>
        When you add a new dictionary you may choose between several sources:
      </para>
      <itemizedlist>
        <listitem>
          <para>Create a new dictionary from the &kde; documentation</para>
          <para>
            If you use this source &kmouth; will ask you for the intended
            language and afterwards parse the &kde; documentation. The
            frequentness of the individual words is detect by simply counting
            the occurrences of each word. Optionally you can compare the word
            list to an OpenOffice.org dictionary in order to only add correctly
            spelled words to the new dictionary.
          </para>
        </listitem>
        <listitem>
          <para>Create a new dictionary from a file</para>
          <para>
            If you use this source &kmouth; will ask you for the intended
            file. You may either select an &XML; file, a standard text file or
            a file containing a word completion dictionary created by either
            &kmouth; or GOK (the GNOME On-screen Keyboard). If you select a
            standard text file or an &XML; file the frequentness of the individual
            words is detected by simply counting the occurrences of each word.
            Optionally you can compare the word list to an OpenOffice.org
            dictionary in order to only add correctly spelled words to the new
            dictionary.
          </para>
        </listitem>
        <listitem>
          <para>Create a new dictionary from a folder</para>
          <para>
            If you use this source &kmouth; will ask you for the intended folder.
            &kmouth; will open all files in that folder and its subfolders.
            Each file is either loaded as a completion dictionary, as an &XML; file
            or as a standard text file. In the latter two cases the occurrences of
            each individual word in the file is counted. Optionally you can compare
            the word list to an OpenOffice.org dictionary in order to only add
            correctly spelled words to the new dictionary.
          </para>
        </listitem>
        <listitem>
          <para>Merge dictionaries</para>
          <para>
            You can use this option in order to merge the available dictionaries.
            &kmouth; will ask you which dictionaries should be merged and how the
            individual dictionaries should be weighted.
          </para>
        </listitem>
        <listitem>
          <para>Create an empty word list</para>
          <para>
            You can use this option in order to create a blank dictionary without
            any entries. As &kmouth; automatically adds newly typed words to the
            dictionaries it will learn your vocabulary with the time.
          </para>
        </listitem>
      </itemizedlist>
    </sect2>
  </sect1>
  <sect1 id="phrasebook-editor">
    <title>The Phrase Book Edit Window</title>
    <para>
      By using the menu entry
      <menuchoice>
        <guimenu>Phrase Books</guimenu><guimenuitem>Edit...</guimenuitem>
      </menuchoice>
      you open the phrase book edit window.
    </para>
    <para>
      <screenshot>
        <screeninfo>The phrase book edit window</screeninfo>
        <mediaobject>
          <imageobject>
            <imagedata fileref="kmouthedit.png" format="PNG"/>
          </imageobject>
          <textobject>
            <phrase>Screenshot</phrase>
          </textobject>
        </mediaobject>
      </screenshot>
    </para>
    <para>
      The main area of the phrase book edit window is divided into two parts.
      Within the upper part the phrase books are displayed in some tree
      structure.
    </para>
    <para>
      Within the lower part you may modify a selected item. If you have
      selected a phrase you can modify the contents of the phrase as well
      as its shortcut. If you have selected a phrase book you can only
      change its name.
    </para>
    <para>
      Actions like adding new phrases and phrase books and deleting selected
      phrases and phrase books can be done by selecting them in either the
      menu bar, the toolbar or a pop up menu.
    </para>
    <para>
      You can change the order of the phrase books and phrases by dragging
      them to their new places or by using the arrow keys while the
      &Alt; key is pressed.
    </para>
  </sect1>

</chapter>

<chapter id="commands">
  <title>Command Reference</title>

  <sect1 id="main-commands">
    <title>Commands Within The Main Window</title>
    <sect2 id="file-menu">
      <title>The File Menu</title>
        <variablelist>
          <varlistentry>
            <term><menuchoice>
              <shortcut>
                <keycombo>&Ctrl;<keycap>O</keycap></keycombo>
              </shortcut>
              <guimenu>File</guimenu>
              <guimenuitem>Open as History...</guimenuitem>
            </menuchoice></term>
            <listitem><para><action>Opens a text file into as history of spoken sentences.</action></para></listitem>
          </varlistentry>
          <varlistentry>
            <term><menuchoice>
              <shortcut>
                <keycombo>&Ctrl;<keycap>S</keycap></keycombo>
              </shortcut>
              <guimenu>File</guimenu>
              <guimenuitem>Save History As...</guimenuitem>
            </menuchoice></term>
            <listitem><para><action>Saves the history into a text file.</action></para></listitem>
          </varlistentry>
          <varlistentry>
            <term><menuchoice>
              <shortcut>
                <keycombo>&Ctrl;<keycap>P</keycap></keycombo>
              </shortcut>
              <guimenu>File</guimenu>
              <guimenuitem>Print History...</guimenuitem>
            </menuchoice></term>
            <listitem><para><action>Prints the history.</action></para></listitem>
          </varlistentry>
          <varlistentry>
            <term><menuchoice>
              <shortcut>
                <keycombo>&Ctrl;<keycap>Q</keycap></keycombo>
              </shortcut>
              <guimenu>File</guimenu>
              <guimenuitem>Quit</guimenuitem>
            </menuchoice></term>
            <listitem><para><action>Quits &kmouth;</action></para></listitem>
          </varlistentry>
        </variablelist>
    </sect2>

    <sect2 id="edit-menu">
      <title>The Edit Menu</title>
        <variablelist>
          <varlistentry>
            <term><menuchoice>
              <shortcut>
                <keycombo>&Ctrl;<keycap>X</keycap></keycombo>
              </shortcut>
              <guimenu>Edit</guimenu>
              <guimenuitem>Cut</guimenuitem>
            </menuchoice></term>
            <listitem><para><action>
              Cuts the selected section and puts it to the clipboard. If there
              is some text selected in the edit field it is placed in the
              clipboard. Otherwise the selected sentences in the history (if
              any) are placed in the clipboard.
            </action></para></listitem>
          </varlistentry>
          <varlistentry>
            <term><menuchoice>
              <shortcut>
                <keycombo>&Ctrl;<keycap>C</keycap></keycombo>
              </shortcut>
              <guimenu>Edit</guimenu>
              <guimenuitem>Copy</guimenuitem>
            </menuchoice></term>
            <listitem><para><action>
              Copies the selected section to the clipboard. If there is some
              text selected in the edit field it is copied to the clipboard.
              Otherwise the selected sentences in the history (if any) are
              copied to the clipboard.
            </action></para></listitem>
          </varlistentry>
          <varlistentry>
            <term><menuchoice>
              <shortcut>
                <keycombo>&Ctrl;<keycap>V</keycap></keycombo>
              </shortcut>
              <guimenu>Edit</guimenu>
              <guimenuitem>Paste</guimenuitem>
            </menuchoice></term>
            <listitem><para><action>
              Pastes the clipboard contents at the current cursor position into
              the edit field.
            </action></para></listitem>
          </varlistentry>
          <varlistentry>
            <term><menuchoice>
              <guimenu>Edit</guimenu>
              <guimenuitem>Speak</guimenuitem>
            </menuchoice></term>
            <listitem><para><action>
              Speaks the currently active sentence(s). If there is some text in
              the edit field it is spoken. Otherwise the selected sentences in
              the history (if any) are spoken.
            </action></para></listitem>
          </varlistentry>
        </variablelist>
    </sect2>

    <sect2 id="phrasebooks-menu">
      <title>The Phrase Books Menu</title>
        <variablelist>
          <varlistentry>
            <term><menuchoice>
              <guimenu>Phrase Books</guimenu>
              <guimenuitem>Edit...</guimenuitem>
            </menuchoice></term>
            <listitem><para>
              Opens the <link linkend="phrasebook-editor">phrase book edit window</link>.
            </para></listitem>
          </varlistentry>
        </variablelist>
<para>
&kmouth; has the common &kde; <guimenu>Settings</guimenu> and <guimenu>Help</guimenu>
menu items, for more information read the sections about the <ulink url="help:/fundamentals/menus.html#menus-settings"
>Settings Menu</ulink> and <ulink url="help:/fundamentals/menus.html#menus-help">Help Menu</ulink>
of the &kde; Fundamentals.
</para>
    </sect2>

  </sect1>

  <sect1 id="pb-editor-commands">
    <title>Commands within the phrase book edit window</title>
    <sect2 id="pbe-file-menu">
      <title>The File Menu</title>
        <variablelist>
          <varlistentry>
            <term><menuchoice>
              <guimenu>File</guimenu>
              <guimenuitem>New Phrase</guimenuitem>
            </menuchoice></term>
            <listitem><para><action>Adds a new phrase.</action></para></listitem>
          </varlistentry>
          <varlistentry>
            <term><menuchoice>
              <guimenu>File</guimenu>
              <guimenuitem>New Phrase Book</guimenuitem>
            </menuchoice></term>
            <listitem><para><action>Adds a new phrase book.</action></para></listitem>
          </varlistentry>
          <varlistentry>
            <term><menuchoice>
              <shortcut>
                <keycombo>&Ctrl;<keycap>S</keycap></keycombo>
              </shortcut>
              <guimenu>File</guimenu>
              <guimenuitem>Save</guimenuitem>
            </menuchoice></term>
            <listitem><para><action>Saves the phrase book.</action></para></listitem>
          </varlistentry>
          <varlistentry>
            <term><menuchoice>
              <guimenu>File</guimenu>
              <guimenuitem>Import...</guimenuitem>
            </menuchoice></term>
            <listitem><para><action>Imports a file and adds its contents to the phrase book</action></para></listitem>
          </varlistentry>
          <varlistentry>
            <term><menuchoice>
              <guimenu>File</guimenu>
              <guimenuitem>Import Standard Phrase Book</guimenuitem>
            </menuchoice></term>
            <listitem><para><action>Imports a standard phrase book and adds its contents to the phrase book</action></para></listitem>
          </varlistentry>
          <varlistentry>
            <term><menuchoice>
              <guimenu>File</guimenu>
              <guimenuitem>Export...</guimenuitem>
            </menuchoice></term>
            <listitem><para><action>Exports the currently selected phrase(s) or phrase book(s) to a file</action></para></listitem>
          </varlistentry>
          <varlistentry>
            <term><menuchoice>
              <shortcut>
                <keycombo>&Ctrl;<keycap>W</keycap></keycombo>
              </shortcut>
              <guimenu>File</guimenu>
              <guimenuitem>Close</guimenuitem>
            </menuchoice></term>
            <listitem><para><action>Closes the window</action></para></listitem>
          </varlistentry>
        </variablelist>
    </sect2>

    <sect2 id="pbe-edit-menu">
      <title>The Edit Menu</title>
        <variablelist>
          <varlistentry>
            <term><menuchoice>
              <shortcut>
                <keycombo>&Ctrl;<keycap>X</keycap></keycombo>
              </shortcut>
              <guimenu>Edit</guimenu>
              <guimenuitem>Cut</guimenuitem>
            </menuchoice></term>
            <listitem><para><action>
              Cuts the selected items and puts it to the clipboard.
            </action></para></listitem>
          </varlistentry>
          <varlistentry>
            <term><menuchoice>
              <shortcut>
                <keycombo>&Ctrl;<keycap>C</keycap></keycombo>
              </shortcut>
              <guimenu>Edit</guimenu>
              <guimenuitem>Copy</guimenuitem>
            </menuchoice></term>
            <listitem><para><action>
              Copies the selected items to the clipboard.
            </action></para></listitem>
          </varlistentry>
          <varlistentry>
            <term><menuchoice>
              <shortcut>
                <keycombo>&Ctrl;<keycap>V</keycap></keycombo>
              </shortcut>
              <guimenu>Edit</guimenu>
              <guimenuitem>Paste</guimenuitem>
            </menuchoice></term>
            <listitem><para><action>
              Pastes the clipboard contents into the phrase book.
            </action></para></listitem>
          </varlistentry>
          <varlistentry>
            <term><menuchoice>
              <guimenu>Edit</guimenu>
              <guimenuitem>Delete</guimenuitem>
            </menuchoice></term>
            <listitem><para><action>
              Deletes the selected items.
            </action></para></listitem>
          </varlistentry>
        </variablelist>
    </sect2>

    <sect2 id="pbe-help-menu">
      <title>The Help Menu</title>
      <para>The items in this menu are the same as in the main window.</para>
    </sect2>

    <sect2 id="pbe-popup-menu">
      <title>The Pop up Menu</title>
        <variablelist>
          <varlistentry>
            <term><menuchoice>
              <guimenuitem>New Phrase</guimenuitem>
            </menuchoice></term>
            <listitem><para><action>Adds a new phrase.</action></para></listitem>
          </varlistentry>
          <varlistentry>
            <term><menuchoice>
              <guimenuitem>New Phrase Book</guimenuitem>
            </menuchoice></term>
            <listitem><para><action>Adds a new phrase book.</action></para></listitem>
          </varlistentry>
          <varlistentry>
            <term><menuchoice>
              <guimenuitem>Import...</guimenuitem>
            </menuchoice></term>
            <listitem><para><action>Imports a file and adds its contents to the phrase book</action></para></listitem>
          </varlistentry>
          <varlistentry>
            <term><menuchoice>
              <guimenuitem>Import Standard Phrase Book</guimenuitem>
            </menuchoice></term>
            <listitem><para><action>Imports a standard phrase book and adds its contents to the phrase book</action></para></listitem>
          </varlistentry>
          <varlistentry>
            <term><menuchoice>
              <guimenuitem>Export...</guimenuitem>
            </menuchoice></term>
            <listitem><para><action>Exports the currently selected phrase(s) or phrase book(s) to a file</action></para></listitem>
          </varlistentry>
          <varlistentry>
            <term><menuchoice>
              <shortcut>
                <keycombo>&Ctrl;<keycap>X</keycap></keycombo>
              </shortcut>
               <guimenuitem>Cut</guimenuitem>
            </menuchoice></term>
            <listitem><para><action>
              Cuts the selected items and puts it to the clipboard.
            </action></para></listitem>
          </varlistentry>
          <varlistentry>
            <term><menuchoice>
              <shortcut>
                <keycombo>&Ctrl;<keycap>C</keycap></keycombo>
              </shortcut>
              <guimenuitem>Copy</guimenuitem>
            </menuchoice></term>
            <listitem><para><action>
              Copies the selected items to the clipboard.
            </action></para></listitem>
          </varlistentry>
          <varlistentry>
            <term><menuchoice>
              <shortcut>
                <keycombo>&Ctrl;<keycap>V</keycap></keycombo>
              </shortcut>
              <guimenuitem>Paste</guimenuitem>
            </menuchoice></term>
            <listitem><para><action>
              Pastes the clipboard contents at this position into the phrase book.
            </action></para></listitem>
          </varlistentry>
          <varlistentry>
            <term><menuchoice>
              <guimenuitem>Delete</guimenuitem>
            </menuchoice></term>
            <listitem><para><action>
              Deletes the selected items.
            </action></para></listitem>
          </varlistentry>
        </variablelist>
    </sect2>
  </sect1>

</chapter>

<chapter id="credits">
  <title>Credits and License</title>

  <para>
    &kmouth;
  </para>
  <para>
    Program copyright 2002-2004 Gunnar Schmi Dt <email>gunnar@schmi-dt.de</email>
  </para>
  <para>
    Documentation copyright 2002-2004 Gunnar Schmi Dt <email>gunnar@schmi-dt.de</email>
  </para>

  <!-- TRANS:CREDIT_FOR_TRANSLATORS -->

  &underFDL;
  &underGPL;
</chapter>

<!--
<appendix id="tts">
  <title>Examples for the text-to-speech configuration</title>
  <qandaset id="ttslist">
      <qandaentry>
      <question>
        <para>Festival</para>
      </question>
      <answer>
        <para>
          Festival is a text-to-speech system written from the University of
          Edinburgh. It currently supports English, Spanish and Welsh speech.
          Its license allows to use and distribute Festival free of charge
          without restrictions.
        </para>
        <para>
          In order to create the command line example for the text-to-speech
          configuration we assume that Festival is installed in the directory
          <filename class="directory">/usr/local/festival/</filename>. The
          command for speaking texts then is as follows:
        </para>
        <para>
          <screen><userinput><command>/usr/local/festival/bin/festival</command> <option>- -tts</option></userinput></screen>
        </para>
        <para>
          The option <guilabel>Send the data as standard input</guilabel> must
          be enabled.
        </para>
      </answer>
    </qandaentry>
    <qandaentry>
      <question>
        <para>FreeTTS</para>
      </question>
      <answer>
        <para>
          FreeTTS is a speech synthesizer written entirely in the &Java;™
          programming language. It currently only has support for English
          pronounciation. Its license allows to use and distribute FreeTTS
          free of charge without restrictions.
        </para>
        <para>
          In order to create the command line example for the text-to-speech
          configuration we assume that FreeTTS is installed in the directory
          <filename class="directory">/usr/local/freetts/</filename>. The
          command for speaking texts then one of the following three examples:
        </para>
        <para>
          <screen><userinput><command>java</command> <option>-jar /usr/local/freetts/lib/freetts.jar</option> <option>-text %t</option></userinput></screen>
        </para>
        <para>
          <screen><userinput><command>java</command> <option>-jar /usr/local/freetts/lib/freetts.jar</option> <option>-file %f</option></userinput></screen>
        </para>
        <para>
          <screen><userinput><command>java</command> <option>-jar /usr/local/freetts/lib/freetts.jar</option></userinput></screen>
        </para>
        <para>
          For the third example the option <guilabel>Send the data as standard
          input</guilabel> must be enabled. (This one is the preferred example
          for the use with FreeTTS.)
        </para>
      </answer>
    </qandaentry>
    <qandaentry>
      <question>
        <para>MBROLA</para>
      </question>
      <answer>
        <para>
          MBROLA is a speech synthesizer for a large number of languages. It
          converts a list of phonemes to a wave file, so you need some other
          tool to convert the text into a list of phonemes. The license of
          MBROLA allows to use and MBROLA free of charge for non-commercial,
          non-military applications.
        </para>
        <para>
          For our example we will use Hadifax in order to convert German texts
          into a list of phonemes suitable for MBROLA. We will assume that
          Hadifax and MBROLA are installed to
          <filename class="directory">/usr/local/hadifax/</filename> and
          <filename class="directory">/usr/local/mbrola/</filename>.
        </para>
        <para>
          Unfortunately Hadifax tends to swallow the last character of the text,
          so we may want to add an additional character to the text. The complete
          command is therefore more complex than the previous examples:
        </para>
        <para>
          <screen><userinput>(<command>cat</command> <option>-</option>; <command>echo</command> <option>&quot; &quot;</option>) | <command>/usr/local/hadifax/txt2pho</command> <option>-f</option>
          | <command>/usr/local/mbrola/mbrola</command> <option>-e</option>
          <option>/usr/local/mbrola/de1/de1 - /tmp/tmp.wav</option>;
          <command>paplay</command> <option>/tmp/tmp.wav</option>; <command>rm</command> <option>/tmp/tmp.wav</option></userinput></screen>
        </para>
        <para>
          All parts of this command need to be written into one line. The option
          <guilabel>Send the data as standard input</guilabel> must be enabled.
        </para>
      </answer>
    </qandaentry>
  </qandaset>
</appendix>
-->

</book>
<!--
Local Variables:
mode: sgml
sgml-minimize-attributes:nil
sgml-general-insert-case:lower
sgml-indent-step:0
sgml-indent-data:nil
End:
-->
