'\" t
.\"     Title: SENDPRAAT
.\"    Author: Rafael Laboissiere
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\"      Date: April 22, 2013
.\"    Manual: User Commands
.\"    Source: Praat
.\"  Language: English
.\"
.TH "SENDPRAAT" "1" "April 22, 2013" "Praat" "User Commands"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
sendpraat \- doing phonetics by computer
.SH "SYNOPSIS"
.HP \w'\fBsendpraat\fR\ 'u
\fBsendpraat\fR [\fItimeOut\fR] {\fIprogram\fR} {\fImessage\fR...}
.SH "DESCRIPTION"
.PP
This manual page documents the
\fBsendpraat\fR
command\&. It was written for the Debian distribution because the original program does not have a manual page\&.
.PP
\fBsendpraat\fR
is a program for sendings messages to a running program that uses the Praat shell, like
\fBpraat\fR(1)\&.
.SH "ARGUMENTS"
.PP
\fIprogram\fR
.RS 4
the name of a running program that uses the Praat shell\&.
.RE
.PP
\fImessage \&.\&.\&.\fR
.RS 4
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\&.
.RE
.PP
\fItimeOut\fR
.RS 4
the number of seconds that sendpraat will wait for an answer before writing an error message\&. A
\fItimeOut\fR
of 0 means that the message will be sent asynchronously, i\&.e\&., that sendpraat will return immediately without issuing any error message\&.
.RE
.SH "EXAMPLES"
.sp
.if n \{\
.RS 4
.\}
.nf
sendpraat 0 praat Quit
.fi
.if n \{\
.RE
.\}
.PP
Causes the program
\fBpraat\fR
to quit (gracefully)\&. This works because "Quit" is a fixed command in Praat\*(Aqs Control menu\&. Sendpraat will return immediately\&.
.sp
.if n \{\
.RS 4
.\}
.nf
sendpraat 1000 praat "Play reverse"
.fi
.if n \{\
.RE
.\}
.PP
Causes the program
\fBpraat\fR, 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\*(Aqs dynamic menu when Sounds are selected\&. Sendpraat will allow "praat" at most 1000 seconds to perform this\&.
.sp
.if n \{\
.RS 4
.\}
.nf
sendpraat praat "execute ~/MyResearch/MyProject/MyScript\&.praat"
.fi
.if n \{\
.RE
.\}
.PP
Causes the program "praat" to execute a script\&. Sendpraat will allow
\fBpraat\fR
at most 10 seconds (the default time out)\&.
.sp
.if n \{\
.RS 4
.\}
.nf
sendpraat als "for i from 1 to 5" "Draw circle\&.\&.\&. 0\&.5 0\&.5 0\&.1*i" "endfor"
.fi
.if n \{\
.RE
.\}
.PP
Causes the program
\fBals\fR
to draw five concentric circles into its Picture window\&.
.SH "AUTHOR"
.PP
This manual page was written by Rafael Laboissiere <<rafael@laboissiere\&.net>> for the Debian system (but may be used by others)\&. It was based on the information provided by the help message of the
\fBsendpraat\fR
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\&.
.PP
On Debian systems, the complete text of the GNU General Public License can be found in /usr/share/common\-licenses/GPL\-3\&.
.SH "SEE ALSO"
.PP
For further information, see the Praat website (http://www\&.praat\&.org)\&.