<?xml version='1.0' encoding='ISO-8859-1'?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" [

<!--

Process this file with an XSLT processor: `xsltproc \
-''-nonet /usr/share/sgml/docbook/stylesheet/xsl/nwalsh/\
manpages/docbook.xsl manpage.dbk'.  A manual page
<package>.<section> will be generated.  You may view the
manual page with: nroff -man <package>.<section> | less'.  A
typical entry in a Makefile or Makefile.am is:

DB2MAN=/usr/share/sgml/docbook/stylesheet/xsl/nwalsh/\
manpages/docbook.xsl
XP=xsltproc -''-nonet

manpage.1: manpage.dbk
        $(XP) $(DB2MAN) $<

The xsltproc binary is found in the xsltproc package.  The
XSL files are in docbook-xsl.  Please remember that if you
create the nroff version in one of the debian/rules file
targets (such as build), you will need to include xsltproc
and docbook-xsl in your Build-Depends control field.

-->

  <!-- Fill in your name for FIRSTNAME and SURNAME. -->
  <!ENTITY dhfirstname "<firstname>Rafael</firstname>">
  <!ENTITY dhsurname   "<surname>Laboissiere</surname>">
  <!-- Please adjust the date whenever revising the manpage. -->
  <!ENTITY dhdate      "<date>April 22, 2013</date>">
  <!-- SECTION should be 1-8, maybe w/ subsection other parameters are
       allowed: see man(7), man(1). -->
  <!ENTITY dhsection   "<manvolnum>1</manvolnum>">
  <!ENTITY dhemail     "<email>rafael@laboissiere.net</email>">
  <!ENTITY dhusername  "Rafael Laboissiere">
  <!ENTITY dhucpackage "<refentrytitle>PRAAT-OPEN-FILES</refentrytitle>">
  <!ENTITY dhpackage   "praat-open-files">

  <!ENTITY debian      "Debian">
  <!ENTITY gnu         "<acronym>GNU</acronym>">
  <!ENTITY gpl         "&gnu; <acronym>GPL</acronym>">
]>

<refentry>
  <refentryinfo>
    <address>
      &dhemail;
    </address>
    <author>
      &dhfirstname;
      &dhsurname;
    </author>
    <copyright>
      <year>2003</year>
      <holder>&dhusername;</holder>
    </copyright>
    &dhdate;
  </refentryinfo>
  <refmeta>
    &dhucpackage;
    &dhsection;
    <refmiscinfo class="manual">User Commands</refmiscinfo>
    <refmiscinfo class="source">Praat</refmiscinfo>
  </refmeta>
  <refnamediv>
    <refname>&dhpackage;</refname>

    <refpurpose>Open sound files with Praat</refpurpose>
  </refnamediv>
  <refsynopsisdiv>
    <cmdsynopsis>
      <command>&dhpackage;</command>
      <arg choice="opt">--new
        <replaceable class="parameter"></replaceable>
      </arg>
      <arg choice="opt">--wait=<replaceable class="parameter">secs</replaceable>
      </arg>
      <arg choice="req" rep="repeat">
        <replaceable class="parameter">file</replaceable>
      </arg>
    </cmdsynopsis>
  </refsynopsisdiv>

  <refsect1>
    <title>DESCRIPTION</title>

    <para>The <command>&dhpackage;</command> command allows opening of
    sound files with <command>praat</command> from the command line.  Any
    file type recognized by Praat (WAV, FLAC, MP3, etc) can be given as
    arguments.</para>

  </refsect1>

  <refsect1>
    <title>OPTIONS</title>

    <variablelist>
      <varlistentry>
        <term>--new</term>
        <listitem>
          <para>
            Launch a new instance of <command>praat</command> for viewing
            and editing the sound files.  By default,
            <command>praat-open-files</command> try to open the files in an
            running <command>praat</command> program, and fails if ther is none.
          </para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term>--wait=<replaceable class="parameter">secs</replaceable></term>
        <listitem>
          <para>
            By default, when the --new option is used,
            <command>praat-open-files</command> waits for 3 seconds before
            sending commands to the newly launched instance of
            <command>praat</command>.  If <command>praat</command> takes
            longer to be launched on your system, specify another value
            with the --wait option.
          </para>
        </listitem>
      </varlistentry>
    </variablelist>

  </refsect1>

  <refsect1>
    <title>EXAMPLES</title>

    <programlisting>praat-open-files file.wav relative/path/file.flac /absolute/path/file.mp3</programlisting>
    
    <para>Open the three specified files with individual View &amp; Edit
    windows for each one on a running instance of
    <command>praat</command>.</para>
    
    <programlisting>praat-open-files --new file.wav</programlisting>

    <para>Open file.wav in a new instance of <command>praat</command>. </para>
    
    <programlisting>praat-open-files --new --wait=5 file.wav</programlisting>

    <para>Open file.wav in a new instance of <command>praat</command>,
    waiting 5 seconds before sending the request to open the file.</para>
    
  </refsect1>

  <refsect1>
    <title>AUTHOR</title>
    <para>&dhusername; &lt;&dhemail;&gt;</para>

  </refsect1>

  <refsect1>

    <title>SEE ALSO</title>

    <para>For further information, see the Praat website
    (http://www.praat.org).</para>

  </refsect1>

</refentry>
