Re: [PATCH] add dpkg-conffile, based upon http://wiki.debian.org/DpkgConffileHandling
On Fri, Jan 25, 2008 at 03:15:49PM -0500, Joey Hess wrote:
> index 0000000..6bd8bf6
> --- /dev/null
> +++ b/man/dpkg-conffile.8
> @@ -0,0 +1,132 @@
> +.\" This is an -*- nroff -*- source file.
> +.\" dpkg-conffile and this manpage are Copyright 2008 by Joey Hess.
> +.\"
> +.\" This is free software; see the GNU General Public Licence version 2
> +.\" or later for copying conditions. There is NO warranty.
> +.TH dpkg\-conffile 8 "2008-1-25" "Debian Project" "dpkg utilities"
> +.SH NAME
> +dpkg\-conffile \- graceful deletion or moving of conffiles
> +.
> +.SH SYNOPSIS
> +.B dpkg\-conffile
> +.I rm <package> <conffile>
> +.P
> +.B dpkg\-conffile
> +.I prep_mv <package> <oldconffile> <newconffile>
> +.P
> +.B dpkg\-conffile
> +.I mv <package> <oldconffile> <newconffile>
> +.
> +.SH DESCRIPTION
> +When upgrading a package, dpkg will not automatically remove a conffile (a
> +configuration filefor which dpkg should preserve user changes) if it is not
^^^^^^
missing space
> +present in the newer version. There are two principal reasons for this; the
[...]
> +.P
> +If the user has not modified the conffile, it is simply removes from the disk.
^^^^^^^
removed
> +If they have, it is moved to a filename that can be easily identified by the
> +user and ignored bytools such as run-parts.
^^^^^
missing space
[...]
> +.SH BUGS
> +Arguably the need for this program at all is a bug in dpkg. If dpkg is
> +ever changed to somehow handle conffile deletion and renaming on its own,
> +this program could turn into a deprecated no-op.
The man page will probably need to mention that packages using that will
need a pre-depends on a version of dpkg containing the script.
Gruesse,
--
Frank Lichtenheld <djpig@debian.org>
www: http://www.djpig.de/
Reply to: