The merge-new-configs utility, usually located at /usr/bin/merge-new-configs, is a helper application used by the update-buildspace application to merge new default configuration files without overwriting those used by the build-space utilities or those critical to the correct operation of the build-space.
The merge-new-configs utility uses the same configuration file as all the other applications in the buildspace-scripts package which is usually located at /etc/buildspace on a standard installation. The sections relevant to the merge-new-configs utility are highlighted in the example below.
# Name of the build space
BUILDSPACE_NAME="x86-64bit-workstation"
# Base path for logs
LOGPATH="/var/log/autobuild"
# List of configuration files to protect from updates.
CONFFILES="aliases bashrc buildspace clock hosts layman.cfg locale.gen make.conf resolv.conf ssmtp.conf"
# List of kernel sources which should not be automatically cleaned.
KERNELS="sys-kernel/gentoo-sources"
As you can see the configuration is a simple space-separated list of file names stored in the CONFFILES variable. The names of the configuration files to protect should not contain any directories and all locations under /etc will be scanned for files matching those listed.
The merge-new-configs has a single mode of operation and requires no command line parameters as long as a suitable CONFFILES setting is provided in the configuration file. Alternatively the list of files may be specified using the -f or --files option followed by a quoted, space separated list of filenames.
Searching for new configurations for:
aliases : none.
bashrc : none.
buildspace : none.
clock : none.
hosts : none.
layman.cfg : none.
locale.gen : none.
make.conf : none.
resolv.conf : none.
ssmtp.conf : none.
Scanning Configuration files...
Exiting: Nothing left to do; exiting. :)