diff options
author | Zac Medico <zmedico@gentoo.org> | 2007-07-30 01:30:17 +0000 |
---|---|---|
committer | Zac Medico <zmedico@gentoo.org> | 2007-07-30 01:30:17 +0000 |
commit | d0e68ac125b0a049eb71b81904336e51b1da3ac1 (patch) | |
tree | bb33043ac174deec3b82429d8f4688c2d1fd5374 /pym | |
parent | 4c3be553ebd538ab4edf2b0b2d6b991879fa028a (diff) | |
download | portage-d0e68ac125b0a049eb71b81904336e51b1da3ac1.tar.gz portage-d0e68ac125b0a049eb71b81904336e51b1da3ac1.tar.bz2 portage-d0e68ac125b0a049eb71b81904336e51b1da3ac1.zip |
For bug #137483, move the `emerge --help config` docs to the emerge man page. Thanks to Arfrever Frehtes Taifersar Arahesis for this patch. (trunk r7430)
svn path=/main/branches/2.1.2/; revision=7431
Diffstat (limited to 'pym')
-rw-r--r-- | pym/emergehelp.py | 44 |
1 files changed, 0 insertions, 44 deletions
diff --git a/pym/emergehelp.py b/pym/emergehelp.py index 8ac754ce9..a9acac607 100644 --- a/pym/emergehelp.py +++ b/pym/emergehelp.py @@ -391,48 +391,4 @@ def help(myaction,myopts,havecolor=1): print " versions or newer ebuilds have become available since you last did a" print " sync and update." print - elif myaction=="config": - outstuff=green("Config file management support (preliminary)")+""" - -Portage has a special feature called "config file protection". The purpose of -this feature is to prevent new package installs from clobbering existing -configuration files. By default, config file protection is turned on for /etc -and the KDE configuration dirs; more may be added in the future. - -When Portage installs a file into a protected directory tree like /etc, any -existing files will not be overwritten. If a file of the same name already -exists, Portage will change the name of the to-be-installed file from 'foo' to -'._cfg0000_foo'. If '._cfg0000_foo' already exists, this name becomes -'._cfg0001_foo', etc. In this way, existing files are not overwritten, -allowing the administrator to manually merge the new config files and avoid any -unexpected changes. - -In addition to protecting overwritten files, Portage will not delete any files -from a protected directory when a package is unmerged. While this may be a -little bit untidy, it does prevent potentially valuable config files from being -deleted, which is of paramount importance. - -Protected directories are set using the CONFIG_PROTECT variable, normally -defined in /etc/make.globals. Directory exceptions to the CONFIG_PROTECTed -directories can be specified using the CONFIG_PROTECT_MASK variable. To find -files that need to be updated in /etc, type: - -# find /etc -iname '._cfg????_*' - -You can disable this feature by setting CONFIG_PROTECT="-*" in /etc/make.conf. -Then, Portage will mercilessly auto-update your config files. Alternatively, -you can leave Config File Protection on but tell Portage that it can overwrite -files in certain specific /etc subdirectories. For example, if you wanted -Portage to automatically update your rc scripts and your wget configuration, -but didn't want any other changes made without your explicit approval, you'd -add this to /etc/make.conf: - -CONFIG_PROTECT_MASK="/etc/wget /etc/rc.d" - -Tools such as dispatch-conf, cfg-update, and etc-update are also available to -aid in the merging of these files. They provide interactive merging and can -auto-merge trivial changes. - -""" - print outstuff |