.TH "ETC-UPDATE" "1" "Mar 2012" "Portage VERSION" "Portage"
.SH "NAME"
etc\-update \- handle configuration file updates
.SH "SYNOPSIS"
.BR etc\-update
[\fIoptions\fR] [\fI--automode <mode>\fR] [\fIpaths to scan\fR]
.SH "DESCRIPTION"
\fIetc\-update\fR is supposed to be run after merging a new package to see if
there are updates to the configuration files.  If a new
configuration file will override an old one, 
\fIetc\-update\fR will prompt the user for a decision.
.PP
\fIetc\-update\fR will check all directories specified on the command
line.  If no paths are given, then the \fICONFIG_PROTECT\fR variable
will be used.  All config files found in \fICONFIG_PROTECT_MASK\fR will
automatically be updated for you by \fIetc\-update\fR.
See \fBmake.conf\fR(5) for more information.
.PP
\fIetc\-update\fR respects the normal \fIPORTAGE_CONFIGROOT\fR and
\fIEROOT\fR variables for finding the aforementioned config protect variables.
.SH "OPTIONS"
.TP
.BR \-d ", " \-\-debug
Run with shell tracing enabled.
.TP
.BR \-h ", " \-\-help
Surprisingly, show the help output.
.TP
.BR \-p ", " \-\-preen
Automerge trivial changes only and quit.
.TP
.BR \-v ", " \-\-verbose
Show settings and important decision info while running.
.TP
.BR "\-\-automode <mode>"
Select one of the automatic merge modes.  Valid modes are: \-3 \-5 \-7 \-9.
See the \fI\-\-help\fR text for more details.
.SH "REPORTING BUGS"
Please report bugs via http://bugs.gentoo.org/
.SH "AUTHORS"
.nf
Jochem Kossen and Leo Lipelis
Karl Trygve Kalleberg <karltk@gentoo.org>
Mike Frysinger <vapier@gentoo.org>
.fi
.SH "FILES"
.TP
.B /etc/etc\-update.conf
Configuration settings for \fIetc\-update\fR are stored here.
.SH "SEE ALSO"
.BR dispatch\-conf (1),
.BR make.conf (5)