man/etc-update.1

   1 .TH "ETC-UPDATE" "1" "Mar 2012" "Portage VERSION" "Portage"
   2 .SH "NAME"
   3 etc\-update \- handle configuration file updates
   4 .SH "SYNOPSIS"
   5 .BR etc\-update
   6 [\fIoptions\fR] [\fI--automode <mode>\fR] [\fIpaths to scan\fR]
   7 .SH "DESCRIPTION"
   8 \fIetc\-update\fR is supposed to be run after merging a new package to see if
   9 there are updates to the configuration files.  If a new
  10 configuration file will override an old one,
  11 \fIetc\-update\fR will prompt the user for a decision.
  12 .PP
  13 \fIetc\-update\fR will check all directories specified on the command
  14 line.  If no paths are given, then the \fICONFIG_PROTECT\fR variable
  15 will be used.  All config files found in \fICONFIG_PROTECT_MASK\fR will
  16 automatically be updated for you by \fIetc\-update\fR.
  17 See \fBmake.conf\fR(5) for more information.
  18 .PP
  19 \fIetc\-update\fR respects the normal \fIPORTAGE_CONFIGROOT\fR and
  20 \fIEROOT\fR variables for finding the aforementioned config protect variables.
  21 .SH "OPTIONS"
  22 .TP
  23 .BR \-d ", " \-\-debug
  24 Run with shell tracing enabled.
  25 .TP
  26 .BR \-h ", " \-\-help
  27 Surprisingly, show the help output.
  28 .TP
  29 .BR \-p ", " \-\-preen
  30 Automerge trivial changes only and quit.
  31 .TP
  32 .BR \-v ", " \-\-verbose
  33 Show settings and important decision info while running.
  34 .TP
  35 .BR "\-\-automode <mode>"
  36 Select one of the automatic merge modes.  Valid modes are: \-3 \-5 \-7 \-9.
  37 See the \fI\-\-help\fR text for more details.
  38 .SH "REPORTING BUGS"
  39 Please report bugs via http://bugs.gentoo.org/
  40 .SH "AUTHORS"
  41 .nf
  42 Jochem Kossen and Leo Lipelis
  43 Karl Trygve Kalleberg <karltk@gentoo.org>
  44 Mike Frysinger <vapier@gentoo.org>
  45 .fi
  46 .SH "FILES"
  47 .TP
  48 .B /etc/etc\-update.conf
  49 Configuration settings for \fIetc\-update\fR are stored here.
  50 .SH "SEE ALSO"
  51 .BR dispatch\-conf (1),
  52 .BR make.conf (5)