.\" $Header: /home/ahuxley/dev/active/fad/man/RCS/mkfad.1,v 1.29 2002/01/03 14:22:16 ahuxley Exp $
.\"
.TH MKFAD 1 "3 January 2002"
.SH NAME
mkfad \- Make a File Attribute Database
.br
.\"
.\" we don't need a .br/.ne 5 here since there
.\" isn't any chance really, that we're already
.\" anywhere near the end of the first page.
.\"
.SH SYNOPSIS
.B "mkfad -V"
.br
.B mkfad
[
.B \-v
|
.B \-d
.I level
] [
.B \-i
.I infile
] [ 
.B \-o
.I outfile
]
.br
.\"
.\" we don't need a .br/.ne 5 here since there
.\" isn't any chance really, that we're already
.\" anywhere near the end of the first page.
.\"
.SH DESCRIPTION
This man page documents 
.I mkfad 
version MARKER_PATCHLEVEL.
.PP
.I Mkfad
is a Perl 
(see
.I perl\fR(1))
script which takes a list of files, such as is generated
by 
.I find\fR(1),
and generates a File Attribute Database (See 
.I fad\fR(5)).
By default it reads the list from standard input and 
writes the database to standard output.
.PP
.I Mkfad
and 
.I faddiff\fR(1) 
were designed as software package management tools,
similar to the commands 
.I mkpdf\fR(1m)
and
.I pdfdiff\fR(1m)
under HP-UX.
.PP 
.I Mkfad
can read and write plain files or files compressed with 
either
.I compress\fR(1)
or 
.I gzip\fR(1). 
All that is necessary to use this feature is to specify
file names with suitable extensions.
.br
.ne 5
.SH OPTIONS
.\"  This indents everything after the next line by 25 some-things.
.TP 25
.B \-V
Print the version number and exit.
.TP
.B \-i
Reads the file list from
.I infile\fR.
The default is to read standard input.
.TP
.B \-o
Writes the database to 
.I outfile\fR.
The default is to write to standard output.
.TP
.B \-v
Sets the verbosity level to 3.
.TP
.B \-d \fIlevel
Sets the verbosity level to
.I level\fR.
.PD
.br
.ne 5
.SH EXAMPLES
The following command generates a FAD database to standard output for the 
entire system
.PP
.nf
find / -print | mkfad
.fi
.ne 5
.SH FILES
See 
.I fad\fR(5).
.br
.ne 5
.SH ENVIRONMENT VARIABLES
See 
.I fad\fR(5).
.br
.ne 5
.SH DIAGNOSTICS
No diagnostic messages are so cryptic that they need to be explained here.
.br
.ne 5
.SH CAVEATS
None.
.br
.ne 5
.SH SEE ALSO
perl(1), fad(5), find(1), faddiff(1), mkpdf(1m), pdfdiff(1m), fadcat(1),
compress(1), gzip(1)
.br
.ne 5
.SH AUTHOR
Alexis Huxley
.br
.ne 5
.SH BUGS
No known bugs.
.PP
Bug reports and queries should be reported to
.B fad-support@danae.demon.co.uk\fR.
.PP
For the latest release of the FAD tools,
visit
.B http://www.danae.demon.co.uk/software/fad/\fR.
.br
.ne 5
.SH COPYRIGHT & DISTRIBUTION POLICY
Copyright (C) 1995-2002 Alexis Huxley
.PP
This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.
.PP
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.
.PP
You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.