.\"  $HeadURL$ $LastChangedRevision$
.\" vim: filetype=nroff
.\"
.TH FADCAT 1 "ADE_APP_TOKEN_RELEASE_DATE_MAN"
.ne 5
.SH NAME
fadcat \- concatenate FAD files
.br
.ne 5
.SH SYNOPSIS
.B fadcat
\*[ade_standard_synopsis_component]
[
.B \-o
.I outfile 
|
.B \-\-file=\fIoutfile
] [
.B \-g 
.I regexp
|
.B \-\-grep=\fIregexp
] [
.I infile \fR ...
]
.br
.ne 5
.SH DESCRIPTION
.B Fadcat
reads the contents of FAD files whose names are specified by 
.I infile\fR,
or it reads standard input if no names are supplied. It 
concatenates the input files, in much the same manner
as 
.B cat\fR(1))
and writes the result to standard output.
.PP
.B Fadcat
can read and write plain files or files compressed with 
either
.B compress\fR(1)
or 
.B gzip\fR(1), 
but only if they have the appropriate file extension and are
specified on the command line, rather than fed through
standard input.
.br
.ne 5
.SH CONFIGURATION
None.
.br
.ne 5
.SH OPTIONS
\*[ade_standard_options_component]
.TP
.B \-g\fR, \fB\-\-grep=\fIregexp\fR
output only those lines which match the specified Perl regular
expression (see
.B perlre\fR(1)).
.TP
.B \-o,\fR, \fB\-\-file=\fIoutfile
Writes to 
.I outfile\fR.
The default is to write to standard output.
.br
.ne 5
.SH EXIT STATUS
On success
.B fadcat
returns zero. On failure it returns non-zero and displays a diagnostic
message.
.br
.ne 5
.SH FILES
None.
.br
.ne 5
.SH ENVIRONMENT VARIABLES
None.
.br
.ne 5
.SH EXAMPLES
The following command merges two FAD files, saving the result:
.IP
.nf
.fam C
.B fadcat file1.fad file2.fad > fad3.fad
.fam T
.fi
.br
.PP
This will extract records from fad3.fad for files
whose name contains the text \(oqfoo', formatting
it into a correctly headered FAD file and send
it to file \(oqfoo.fad':
.IP
.nf
.fam C
.B fadcat -g foo -o foo.fad fad3.fad
.fam T
.fi
.br
.ne 5
.SH CAVEATS
None.
.br
.ne 5
.SH STANDARDS
This manual page documents version ADE_APP_TOKEN_RELEASE_ID of
.B fadcat\fR.
.br
.ne 5
.SH SEE ALSO
perlre(1), fad(5), find(1), faddiff(1), compress(1), gzip(1), cat(1), fad-config(1)
.br
.ne 5
.SH AUTHOR
ADE_APP_TOKEN_AUTHOR_NAME <ADE_APP_TOKEN_AUTHOR_EMAIL>
.br
.ne 5
.SH COPYRIGHT & DISTRIBUTION POLICY
Copyright (C) 1995-ADE_APP_TOKEN_RELEASE_YEAR ADE_APP_TOKEN_AUTHOR_NAME
\*[ade_standard_copyright_component]