trre.1

.\" Process this file with
.\" groff -man -Tascii trre.1
.\"
.TH TRRE 1 "User Commands"
.SH NAME
trre \- stream text editor using transductive regular expressions
.SH SYNOPSIS
.B trre
[\fB\-mad\fR]
.I PATTERN
[\fIFILE\fR]
.SH DESCRIPTION
.B trre
is a stream editor that performs text transformations based on transductive regular expressions. Similar to
.BR sed (1),
it processes input in a single pass. The transformation is entirely defined by the
.IR PATTERN .

If no input file is specified,
.B trre
reads from standard input.
.SH OPTIONS
.IP \fB\-m\fR
Enable matching mode. The expression must match the entire input string.
.IP \fB\-a\fR
Print all possible output strings. Useful in matching mode.
.IP \fB\-d\fR
Enable debug mode. Prints the parsing tree and automaton to stderr.
.SH EXAMPLES
.IP "\fBecho cat | trre c:da:ot:g\fR"
Transforms the word "cat" to "dog".
.IP "\fBecho cat | trre '(cat):(dog)'\fR"
Transforms the word "cat" to "dog".
.SH BUGS
This is an experimental tool. Use with caution.
.SH AUTHOR
Konstantin Selivanov <konstantin dot selivanov at g mail com>
.SH "SEE ALSO"
.BR sed (1),
.BR tr (1)