.TH canon 1 "canon 1.0" "2013"

.SH NAME

canon \- file canonicalization

.SH SYNOPSYS

canon [options] [infile [outfile]]
.PP
Options:
.PP
[\-hv] [\-\-force] [\-\-help] [\-\-version]

.SH DESCRIPTION

.PP
Canonicalize a plain text file.  The canonicalization converts text
with a <CR><LF> sequence at the end of a line of text, no trailing
spaces or tabs on a line of text, and no trailing blank lines.

The input file can use any of the traditional approaches to line
termination.  In DOS/Windows, text lines end with a Carriage
Return (CR) followed by a Line Feed (LF).  In Unix, text lines end
with a single Newline character, which is a Line Feed (LF) character.
In Macintosh, text lines end with a single Newline character, which
is a Carriage Return (CR) character.

If no infile is provided, then stdin is used.

If no outfile is provided, then stdout is used.

.SH OPTIONS

The following options are available:
.TP
.B \-h \-\-help
Print online help.

.TP
.B \-v \-\-version
Print version information.

.SH EXAMPLES

.LP
Get input from stdin and write output to stdout.
.IP
.B canon

.LP
Get input from a.txt and write output to stdout.
.IP
.B canon a.txt

.LP
Canonicalize a.txt, and write the output to b.txt.
.IP
.B canon a.txt b.txt

.SH SEE ALSO
unix2dos(1) dos2unix(1) iconv(1)