Package: debconf
Version: 1.5.28
Severity: wishlist
Tags: patch

During Debian Installer installations logs frequently show the warning that 
the TITLE command is deprecated, but this is currently not documented in 
the debconf-devel man page.

Attached a proposed patch to fix this.

diff -ur debconf-1.5.28.orig/doc/man/debconf-devel.7 debconf-1.5.28/doc/man/debconf-devel.7
--- debconf-1.5.28.orig/doc/man/debconf-devel.7	2009-12-10 13:59:58.000000000 +0100
+++ debconf-1.5.28/doc/man/debconf-devel.7	2009-12-10 14:13:12.000000000 +0100
@@ -266,17 +266,21 @@
 replies for you.
 .RE
 .TP
-.B TITLE string
-This sets the title debconf displays to the user. You rarely need to use
-this command since debconf can automatically generate a title based on
-your package's name.
-.TP
 .B SETTITLE question
-This sets the title to the short description of the template for the
-specified question. The template should be of type title. The advantage
-this has over the TITLE command is that it allows for titles to be stored
-in the same place as the rest of the debconf questions, and allows them to
-be translated.
+.RS
+This sets the title debconf displays to the user, using the short description
+of the template for the specified question. The template should be of type
+title. You rarely need to use this command since debconf can automatically
+generate a title based on your package's name.
+.P
+Setting the title from a template means they are stored in the same place
+as the rest of the debconf questions, and allows them to be translated.
+.RE
+.TP
+.B TITLE string
+This sets the title debconf displays to the user to the specified string.
+This command is deprecated and may be removed in the future; the SETTITLE
+command should be used instead.
 .TP
 .B INPUT priority question
 .RS

Reply via email to