diff options
Diffstat (limited to 'man/updateconf.8')
| -rw-r--r-- | man/updateconf.8 | 49 |
1 files changed, 49 insertions, 0 deletions
diff --git a/man/updateconf.8 b/man/updateconf.8 new file mode 100644 index 0000000..d73e4e1 --- /dev/null +++ b/man/updateconf.8 @@ -0,0 +1,49 @@ +.\" -*- mode: troff; coding: utf-8 -*- +.TH UPDATECONF 8 +.SH NAME +updateconf \- interactive .new configuration file merge tool +.SH DESCRIPTION +.LP +\fBupdateconf\fR is an interactive tool for handling \fI.new\fR configuration +files. When packages are upgraded, new default configuration files are installed +with a \fI.new\fR suffix to avoid overwriting locally modified files. +\fBupdateconf\fR helps merge, discard, or keep these files. +.SH USAGE +.LP +\f(CRupdateconf\fR +.PP +Must be run as root. The script scans \fI/etc\fR for files ending in \fI.new\fR +and presents each one interactively. +.SH INTERACTIVE PROMPT +.LP +For each \fI.new\fR file, a unified diff between the current and new version is +shown, and the user is prompted: +.TP +\fBU\fR +Update: replace the current file with the new one. +.TP +\fBD\fR +Discard: delete the \fI.new\fR file, keeping the current version. +.TP +\fBE\fR +Edit: open the current file in the editor (\fB$EDITOR\fR, defaults to \fIvi\fR). +.TP +\fBK\fR +Keep: keep both files, no changes. +.SH ENVIRONMENT +.TP +\fBEDITOR\fR +Editor to use (default: \fIvi\fR). +.SH EXAMPLES +.LP +\f(CRupdateconf\fR - Run the interactive config file updater. +.SH AUTHORS +.LP +emmett1 \c +.MT me@emmett1.my +.ME +.SH REPORTING BUGS +.LP +Please report bugs and issues in the project issue tracker: \c +.UR https://codeberg.org/emmett1/autils/issues +.UE |