.TH COMMANDLINE 1carl CARL
.SH NAME
commandline - demonstration program for crack(3carl)
.SH SYNOPSIS
.B commandline [flags] [files]
.sp
.nf
.RS 1i
	-a[optional arithmetic expression]
	-b[option]
	-c
	-d
.RE
example: commandline -a2+2 -bfoo -c -d file1 file2 file3
or: commandline -cd -a4K -bfred file1 file2 file3
.fi
.SH DESCRIPTION
.B commandline
is a demonstration program for the
.B crack(3carl)
command line scanning subroutine.  It reads command line format
as described in the synopsis, and prints out the scanned format.
.PP
The -a flag takes an optional arithmetic expression, parsed by
.B sfexpr(3carl).
The -b flag takes a string option.  The -c and -d flags take no
options.
.PP
The best way to observe its behavior is to try a few combinations,
trying various expressions (watch out for the arithmetic operator '*',
which is interpreted first by the shell for regular expression syntax),
and legal and illegal combinations to see how 
.B commandline
recovers.
.SH AUTHOR
Gareth Loy
.SH SEE ALSO
.B crack(3carl),
.B expr(3carl),
.B sfexpr(3carl).
For a more real-world application, which may include rescanning arguments,
and use of the \fIignore\fR argument to 
.B crack(),
see the code for the program
.B xform(1carl).
