          &dhemail;

&dhfirstname; &dhsurname;
2003 &dhusername;
&dhdate;
&dhucpackage; &dhsection; User Commands Praat
&dhpackage; doing phonetics by computer
`&dhpackage;` timeOut program message

## DESCRIPTION

This manual page documents the `&dhpackage;` command. It was written for the &debian; distribution because the original program does not have a manual page.

`&dhpackage;` is a program for sendings messages to a running program that uses the Praat shell, like praat 1.

## ARGUMENTS

program

  the name of a running program that uses the Praat shell.

message ...

  a sequence of Praat shell lines (commands and directives). Each line is a separate argument. Lines that contain spaces should be put inside double quotes.

timeOut

  the number of seconds that sendpraat will wait for an answer before writing an error message. A timeOut of 0 means that the message will be sent asynchronously, i.e., that sendpraat will return immediately without issuing any error message.

## EXAMPLES

    sendpraat 0 praat Quit

Causes the program `praat` to quit (gracefully). This works because "Quit" is a fixed command in Praat's Control menu. Sendpraat will return immediately.

    sendpraat 1000 praat "Play reverse"

Causes the program `praat`, which can play sounds, to play the selected Sound objects backwards. This works because "Play reverse" is an action command that becomes available in Praat's dynamic menu when Sounds are selected. Sendpraat will allow "praat" at most 1000 seconds to perform this.

    sendpraat praat "execute ~/MyResearch/MyProject/MyScript.praat"

Causes the program "praat" to execute a script. Sendpraat will allow `praat` at most 10 seconds (the default time out).

    sendpraat als "for i from 1 to 5" "Draw circle... 0.5 0.5 0.1*i" "endfor"

Causes the program `als` to draw five concentric circles into its Picture window.

## AUTHOR

This manual page was written by &dhusername; <&dhemail;> for the &debian; system (but may be used by others). It was based on the information provided by the help message of the `&dhpackage;` program itself. Permission is granted to copy, distribute and/or modify this document under the terms of the &gnu; General Public License, Version 3 any later version published by the Free Software Foundation.

On Debian systems, the complete text of the GNU General Public License can be found in /usr/share/common-licenses/GPL-3.

## SEE ALSO

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