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