Document the SETTITLE command in the debconf policy. Inclusion of this
command should not pose any problems as it has been supported since 2003
(debconf version 1.3.22).
Patch from Frans Pop <elendil@planet.nl>.
<articleinfo>
<title>Configuration management</title>
<articleinfo>
<title>Configuration management</title>
- <subtitle>Protocol version 2</subtitle>
- <releaseinfo>Revision 7.0</releaseinfo>
+ <subtitle>Protocol version 2.1</subtitle>
+ <releaseinfo>Revision 7.1</releaseinfo>
<author>
<firstname>
Wichert
<author>
<firstname>
Wichert
<para>
This exchanges with the frontend the protocol version
number that is being used. The current version is
<para>
This exchanges with the frontend the protocol version
number that is being used. The current version is
- 2.0. Versions in the 2.x series will be
+ 2.1. Versions in the 2.x series will be
backwards-compatible. You may specify the protocol version
number you are speaking. The frontend will return the version
of the protocol it speaks. If the version you specify is too
backwards-compatible. You may specify the protocol version
number you are speaking. The frontend will return the version
of the protocol it speaks. If the version you specify is too
</table>
</para>
</listitem>
</table>
</para>
</listitem>
-<listitem id="command_title">
+<listitem id="command_settitle">
- TITLE
- <parameter>string</parameter>
+ SETTITLE
+ <parameter>template</parameter>
</para>
<para>
You can use this command to set a title in the
</para>
<para>
You can use this command to set a title in the
of the frontend's window. If you don't specify anything, a
title will automatically be generated.
</para>
of the frontend's window. If you don't specify anything, a
title will automatically be generated.
</para>
+ <para>
+ Using a template has the advantage that titles are translatable
+ and that they can be maintained in the same place as other text
+ displayed to users.
+ </para>
+</listitem>
+<listitem id="command_title">
+ <para>
+ TITLE
+ <parameter>string</parameter>
+ </para>
+ <para>
+ Similar to SETTITLE, but takes a string instead of a template as
+ parameter. Consequence is that the title will not be translatable,
+ unless some other mechanism (like gettext) is used.
+ </para>
</listitem>
<listitem id="command_stop">
<para>
</listitem>
<listitem id="command_stop">
<para>
as is possible.
</entry>
</row>
as is possible.
</entry>
</row>
+ <row>
+ <entry>title</entry>
+ <entry>
+ Holds a (short) string that can be displayed using the SETTITLE
+ command. Only the value of the short description will be used.
+ </entry>
+ </row>
</tbody>
</tgroup>
</table>
</tbody>
</tgroup>
</table>
Seconded: Emilio Pozuelo Monfort <pochu@debian.org>
Seconded: Andrew McMillan <andrew@morphoss.com>
Closes: #575639
Seconded: Emilio Pozuelo Monfort <pochu@debian.org>
Seconded: Andrew McMillan <andrew@morphoss.com>
Closes: #575639
+ * Debconf: Add SETTITLE, like title but uses a template
+ Wording: Frans Pop <elendil@planet.nl>
+ Seconded: Russ Allbery <rra@debian.org>
+ Seconded: Ben Pfaff <blp@cs.stanford.edu>
* Perl Policy: Change perlapi provides to use an ABI version
Wording: Niko Tyni <ntyni@debian.org>
Seconded: Russ Allbery <rra@debian.org>
* Perl Policy: Change perlapi provides to use an ABI version
Wording: Niko Tyni <ntyni@debian.org>
Seconded: Russ Allbery <rra@debian.org>
in <file>debian/copyright</file>, although it will still be in
common-licenses for the time being.
</item>
in <file>debian/copyright</file>, although it will still be in
common-licenses for the time being.
</item>
+<tag>debconf</tag>
+ <item>Add <tt>SETTITLE</tt> (which has been supported for some time).
+ Like <tt>TITLE</tt> but takes a template instead of a string to allow
+ translation.
+ </item>
<tag>perl</tag>
<item><package>perl-base</package> now
provides <package>perlapi-<var>abiname</var></package> instead of a
<tag>perl</tag>
<item><package>perl-base</package> now
provides <package>perlapi-<var>abiname</var></package> instead of a