.\" Generated by manscript from tdrerecord.1.txt
.TH "TDRERECORD" "1" "2013/03/03" "2.2" "termdebug"
.SH NAME
tdrerecord \- rerecord output of a terminal program
.SH SYNOPSIS
\fBtdrerecord\fR [OPTIONS] \fIRECORDING\fR
.SH DESCRIPTION
\fBtdrerecord\fR re-records the output of a terminal program, by replaying the input
from a recording. This allows a new recording to created based on the same
input, after modifying the behaviour of the program. Without options,
\fBtdrerecord\fR will create the recording in the file
tdrecord-\fIyear\fR\-\fImonth\fR\-\fIday\fR@\fIhour\fR:\fIminute\fR:\fIsecond\fR.
.PP
\fBNote\fR that \fBtdrerecord\fR does \fBnot\fR check whether the output conforms to the
recorded output. This can be dangerous as the input may not be in sync with the
output. Depending on the possible actions of the program being run this can
cause data corruption.
.SH OPTIONS
\fBtdrerecord\fR accepts the following options:
.PP
.TP
\fB\-h\fR, \fB\-\-help\fR
Display a short help message.
.TP
\fB\-V\fR, \fB\-\-version\fR
Print version and copyright information.
.TP
\fB\-d\fR \fIdir\fR, \fB\-\-directory\fR=\fIdir\fR
Create the recording in directory \fIdir\fR. This option can not be used
together with the \fB\-o\fR/\fB\-\-output\fR option.
.TP
\fB\-o\fR \fIfile\fR, \fB\-\-output\fR=\fIfile\fR
Save the output in \fIfile\fR. This option can not be used togehter with the
\fB\-d\fR/\fB\-\-directory\fR option.
.TP
\fB\-l\fR, \fB\-\-no\-strip\-location\-reports\fR
Do not remove ANSI cursor location reports from the recorded client input.
These reports are normally generated on request by the client program.
Including these in the client input will result in duplicate location
reports which is likely to confuse the client. However, in some cases it
may be necessary to retain these strings (e.g. if they were not generated
in response to a client request).
.PP
To stop \fBtdrerecord\fR from interpreting file names that start with a dash as
options, one can specify a double dash (\-\-) after which \fBtdrerecord\fR will
interpret any following arguments as files to read.
.SH BUGS
If you think you have found a bug, please check that you are using the latest
version of \fBtermdebug\fR <http://os.ghalkes.nl/termdebug>. When reporting bugs,
please include a minimal example that demonstrates the problem.
.SH AUTHOR
G.P. Halkes <termdebug@ghalkes.nl>
.SH COPYRIGHT
Copyright \(co 2010,2012\-2013 G.P. Halkes
.br
\fBtermdebug\fR is licensed under the GNU General Public License version 3.
.br
For more details on the license, see the file COPYING in the documentation
directory. On Un*x systems this is usually /usr/share/doc/termdebug.
.SH SEE\ ALSO
\fBtermdebug\fR(1), \fBtdrecord\fR(1), \fBtdreplay\fR(1), \fBtdview\fR(1), \fBtdcompare\fR(1)