Package: debconf
Version: 1.5.53
Severity: normal

Hi there,

The debconf.conf(5) man page says of the PackageDir driver:

  This driver is configurable in the same ways as is the DirTree
  driver, plus ...

and of the DirTree driver's Extension setting:

  Must be set to a non-empty string; defaults to ".dat"

This is correct for the DirTree driver; however,
Debconf/DbDriver/PackageDir.pm has both perldoc and code in agreement
that the default value for Extension for PackageDir is "".

This seems most likely to be a bug in the man page, but I'm not certain
of that, mostly because changing Debconf::DbDriver::Directory to
default extension to ".dat" would make the PackageDir and DirTree
drivers more consistent with each other.

I am attaching a patch which updates the man page to more completely
describe the behaviour of the code.

Thanks,
Steven.

-- System Information:
Debian Release: jessie/sid
  APT prefers unstable
  APT policy: (800, 'unstable'), (700, 'experimental')
Architecture: amd64 (x86_64)
Foreign Architectures: i386

Kernel: Linux 3.14-1-amd64 (SMP w/4 CPU cores)
Locale: LANG=en_AU.utf8, LC_CTYPE=en_AU.utf8 (charmap=UTF-8)
Shell: /bin/sh linked to /bin/dash

Versions of packages debconf depends on:
ii  perl-base  5.18.2-3

Versions of packages debconf recommends:
ii  apt-utils     1.0.3
ii  debconf-i18n  1.5.53

Versions of packages debconf suggests:
ii  debconf-doc                1.5.53
ii  debconf-utils              1.5.53
ii  dialog                     1.2-20140219-1
pn  libgtk2-perl               <none>
ii  libnet-ldap-perl           1:0.6200+dfsg-1
ii  libqtcore4-perl            4.8.4-1+b1
ii  libqtgui4-perl             4.8.4-1+b1
pn  libterm-readline-gnu-perl  <none>
ii  perl                       5.18.2-3
ii  whiptail                   0.52.15-3+b1

-- debconf information excluded
>From 1723513e7c0828382ad5f1d58644db5dfbdb27a8 Mon Sep 17 00:00:00 2001
From: Steven McDonald <[email protected]>
Date: Tue, 13 May 2014 18:50:19 +1000
Subject: [PATCH] Document the default setting of Extension for the PackageDir
 driver

The PackageDir driver is documented as having configuration nearly
identical to the DirTree driver, but debconf.conf(5) does not mention
that the default value for Extension is different. This patch documents
that difference.
---
 doc/man/debconf.conf.5 | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/doc/man/debconf.conf.5 b/doc/man/debconf.conf.5
index 6b34d20..af691fb 100644
--- a/doc/man/debconf.conf.5
+++ b/doc/man/debconf.conf.5
@@ -200,10 +200,15 @@ room than the File database driver.
 .P
 This driver is configurable in the same ways as is the DirTree driver,
 plus:
+.RS
+.TP
+.B Extension
+An extension to add to the names of files. Defaults to "" (the empty string).
 .TP
 .B Mode
 The permissions to create files with. Defaults to 600, since the files could
 contain passwords in some circumstances.
+.RE
 .P
 As example stanza setting up a database using this driver:
 .P
-- 
2.0.0.rc2

Reply via email to