.TH pkgadd.conf 5 "October 30, 2002" "rltools #VERSION#" ""
.SH NAME
pkgadd.conf \- configuration for pkgadd(8)
.SH SYNOPSIS
The \fBpkgadd.conf\fP file contains settings for the pkgadd(8) program.
When pkgadd is in upgrade mode, the file will be read. It contains rules
describing how pkgadd should behave when upgrading a package.
.SH FILE FORMAT
A rule is built out of three fragments, \fIevent\fP, \fIpattern\fP and
\fIaction\fP. The event describes in what kind of situation this rule
applies. Currently only one type of event is supported, that is 
\fBUPGRADE\fP. The pattern is a regular expression and the action 
applicable to the \fBUPGRADE\fP event is \fBYES\fP and \fBNO\fP. More
than one rule of the same event type is allowed, in which case the first 
rule will have the lowest priority and the last rule will have the 
highest priority. Example:

.nf
UPGRADE         ^etc/.*$                NO
UPGRADE         ^var/log/.*$            NO
UPGRADE         ^etc/X11/.*$            YES
UPGRADE         ^etc/X11/XF86Config$    NO
.fi

The above example will cause pkgadd to never upgrade anything in /etc/
or /var/log/ (subdirectories included), except files in /etc/X11/
(subdirectories included), unless it is the file /etc/X11/XF86Config. 
The default rule is to upgrade everything, rules in this file are
exceptions to that rule. (NOTE! A \fIpattern\fP should never contain an
initial "/" since you are referring to the files in the package, not the
files on the disk.)

.SH SEE ALSO
pkgadd(8), pkgrm(8), pkginfo(8)
.SH AUTHOR
.nf
Per Liden <per@fukt.bth.se>
Ported to ROOT by John Eriksson <johne@rootlinux.org>
.fi
