.\" Generated by manscript from dwfilter.1.txt
.TH "DWFILTER" "1" "2018/12/06" "Version $VERSION$" "reformat text for processing"
.hw /usr/share/doc/dwdiff-$VERSION$ http://os.ghalkes.nl/dwdiff.html
.SH NAME
dwfilter \- reformat text with dwdiff for further processing
.SH SYNOPSIS
\fBdwfilter\fR [\fIOPTIONS\fR] \fIOLD FILE\fR \fINEW FILE\fR \fIPOST PROCESSOR\fR [\fIPOST PROCESSOR OPTIONS\fR]
.SH DESCRIPTION
\fBdwfilter\fR reformats the text in the old file according to the contents of
the new file (or vice versa) and subsequently passes the reformated old file
and the new file through a secondary filter. It's main use is to allow visual
diff programs such as \fBmeld\fR and \fBkdiff3\fR to be used, even though a text
file has been reformated after editing. A further use is to allow the creation
of small patches even when the new text has been reformated. \fBdwfilter\fR
uses \fBdwdiff\fR for reformatting.
.SH OPTIONS
.TP
\fB\-r\fR, \fB\-\-reverse\fR
Reformat the new file based on the contents of the old file instead of the
default where the old file is reformated based on the contents of the new file.
.PP
\fBdwfilter\fR accepts the following \fBdwdiff\fR options:
.PP
.RS
\fB\-d\fR \fIdelimiters\fR, \fB\-\-delimiters\fR=\fIdelimiters\fR
.br
\fB\-P\fR, \fB\-\-punctuation\fR
.br
\fB\-W\fR \fIwhitespace\fR, \fB\-\-white\-space\fR=\fIwhitespace\fR
.br
\fB\-i\fR, \fB\-\-ignore\-case\fR
.br
\fB\-I\fR, \fB\-\-ignore\-formatting\fR
.br
\fB\-D\fR \fIoption\fR, \fB\-\-diff\-option\fR=\fIoption\fR
.br
\fB\-C\fR\fInum\fR, \fB\-\-context\fR=\fInum\fR
.br
\fB\-m\fR\fInum\fR, \fB\-\-match\-context\fR=\fInum\fR
.br
\fB\-\-aggregate\-changes\fR
.br
\fB\-\-wdiff\-output\fR
.br
\fB\-A\fR \fIalgorithm\fR,  \fB\-\-algorithm\fR=\fIalgorithm\fR
.br
\fB\-\-profile\fR=\fIname\fR, \fB\-\-no\-profile\fR
.RE
.PP
See the \fBdwdiff\fR manual page for the meaning.
.PP
A single dash (\-) as a file can be used to denote standard input. Only one
file can be read from standard input. To stop \fBdwfilter\fR from interpreting
file names that start with a dash as options, one can specify a double dash
(\-\-) after which \fBdwfilter\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 \fBdwdiff\fR <http://os.ghalkes.nl/dwdiff.html>. When reporting
bugs, please include a minimal example that demonstrates the problem.
.SH AUTHOR
G.P. Halkes <dwdiff@ghalkes.nl>
.SH COPYRIGHT
Copyright \(co 2006\-2010 G.P. Halkes
.br
dwdiff 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/dwdiff-$VERSION$.
.SH SEE\ ALSO
\fBdwdiff\fR(1), \fBdiff\fR(1), \fBmeld\fR(1), \fBkdiff3\fR(1)