man/dispatch-conf.1

   1 .TH "DISPATCH-CONF" "1" "Jan 2011" "Portage VERSION" "Portage"
   2 .SH "NAME"
   3 dispatch\-conf \- Sanely update configuration files after emerging new packages
   4 .SH "SYNOPSIS"
   5 .B dispatch\-conf
   6 .SH "DESCRIPTION"
   7 \fIdispatch\-conf\fR is designed to be run after merging new packages
   8 in order to see if there are updates to the configuration files.
   9 If a new configuration file will overwrite an old one, \fIdispatch\-conf\fR
  10 will prompt the user for a decision about how to resolve the discrepancy.
  11 Advantages of \fIdispatch\-conf\fR include easy rollback (changes to config
  12 files are stored either using patches or rcs) and the ability to
  13 automatically update config files that the user has never modified or
  14 that differ from the current version only in CVS cruft or white space.
  15
  16 \fIdispatch\-conf\fR will check all directories in the \fICONFIG_PROTECT\fR
  17 variable.  All config files found in \fICONFIG_PROTECT_MASK\fR will
  18 automatically be updated for you by \fIdispatch\-conf\fR.  See
  19 \fBmake.conf\fR(5) for more information.
  20 .SH "OPTIONS"
  21 .TP
  22 None.
  23 .SH "USAGE"
  24 \fIdispatch\-conf\fR must be run as root, since the config files to be
  25 replaced are generally owned by root.  Before running \fIdispatch\-conf\fR
  26 for the first time the settings in \fB/etc/dispatch\-conf.conf\fR
  27 should be edited and the archive directory specified in
  28 \fB/etc/dispatch\-conf.conf\fR will need to be created.  All changes to
  29 config files will be saved in the archive directory either as patches
  30 or using rcs, making restoration to an earlier version rather simple.
  31
  32 When \fIdispatch\-conf\fR finds a config file that has a new update the user
  33 is provided with a menu of options for how to handle the update:
  34 .TP
  35 .B u
  36 Update (replace) the current config file with the new config file and continue.
  37 .TP
  38 .B z
  39 Zap (delete) the new config file and continue.
  40 .TP
  41 .B n
  42 Skip to the next config file, leaving both the original config file and any
  43 \fICONFIG_PROTECT\fRed files.
  44 .TP
  45 .B e
  46 Edit the new config file, using the editor defined in \fIEDITOR\fR.
  47 .TP
  48 .B m
  49 Interactively merge the current and new config files.
  50 .TP
  51 .B l
  52 Look at the differences between the pre-merged and merged config files.
  53 .TP
  54 .B t
  55 Toggle between the merged and pre-merged config files (in terms of which
  56 should be installed using the \fBu\fR command).
  57 .TP
  58 .B h
  59 Display a help screen.
  60 .TP
  61 .B q
  62 Quit \fIdispatch\-conf\fR.
  63 .SH "FILE MODES"
  64 \fBWARNING:\fR When \fB/etc/dispatch\-conf.conf\fR is configured
  65 to use \fBrcs\fR(1), read and execute permissions of archived
  66 files may be inherited from the first check in of a working file,
  67 as documented in the \fBci\fR(1) man page. This means that even
  68 if the permissions of the working file have since changed, the
  69 older permissions of the first check in may be inherited. As
  70 mentioned in the \fBci\fR(1) man page, users can control access
  71 to RCS files by setting the permissions of the directory
  72 containing the files.
  73 .SH "REPORTING BUGS"
  74 Please report bugs via http://bugs.gentoo.org/
  75 .SH "AUTHORS"
  76 .nf
  77 Jeremy Wohl
  78 Karl Trygve Kalleberg <karltk@gentoo.org>
  79 Mike Frysinger <vapier@gentoo.org>
  80 Grant Goodyear <g2boojum@gentoo.org>
  81 .fi
  82 .SH "FILES"
  83 .TP
  84 .B /etc/dispatch\-conf.conf
  85 Configuration settings for \fIdispatch\-conf\fR are stored here.
  86 .SH "SEE ALSO"
  87 .BR make.conf (5),
  88 .BR ci (1),
  89 .BR etc-update (1),
  90 .BR rcs (1)