[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

Bug#401415: marked as done (developers-reference: Fixes for the debconf templates writing guide)

Your message dated Thu, 28 Feb 2008 11:47:02 +0000
with message-id <E1JUhE6-00078R-Vz@ries.debian.org>
and subject line Bug#401415: fixed in developers-reference 3.3.9
has caused the Debian Bug report #401415,
regarding developers-reference: Fixes for the debconf templates writing guide
to be marked as done.

This means that you claim that the problem has been dealt with.
If this is not the case it is now your responsibility to reopen the
Bug report if necessary, and/or fix the problem forthwith.

(NB: If you are a system administrator and have no idea what this
message is talking about, this may indicate a serious mail system
misconfiguration somewhere. Please contact owner@bugs.debian.org
immediately.)


-- 
401415: http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=401415
Debian Bug Tracking System
Contact owner@bugs.debian.org with problems
--- Begin Message --- 
Package: developers-reference
Version: 3.3.7
Severity: minor
Tags: patch

Hi,

Please find attached a patch with two fixes for the debconf templates
writing guide:
* the "error" type is now perfectly dealt with by debconf
* the extended description should never include a question. It was
  initially restricted to the boolean templates because of the yes/no
  form, where it is more current to see a question, but maintainers tend
  to add questions everywhere. The prompting style should only be part of
  the short description.

Cheers,

-- 
Thomas Huriaux

Index: developers-reference.sgml
===================================================================
RCS file: /cvs/debian-doc/ddp/manuals.sgml/developers-reference/developers-reference.sgml,v
retrieving revision 1.315
diff -u -r1.315 developers-reference.sgml
--- developers-reference.sgml	12 Nov 2006 11:05:22 -0000	1.315
+++ developers-reference.sgml	3 Dec 2006 11:41:45 -0000
@@ -4383,13 +4383,6 @@
 
 	<sect3>error:
 	<p>
-<strong>THIS TEMPLATE TYPE IS NOT HANDLED BY DEBCONF YET.</strong>
-	<p>
-It has been added to cdebconf, the C version of debconf, first used in
-the Debian Installer.
-	<p>
-Please do not use it unless debconf supports it.
-	<p>
 This type is designed to handle error message. It is mostly similar to
 the "note" type. Frontends may present it differently (for instance,
 the dialog frontend of cdebconf draws a red screen instead of the
@@ -4430,6 +4423,8 @@
 because that means that in the classical dialog interface,
 people will need to scroll, and lot of people just don't do that.
 	<p>
+The extended description should <strong>not</strong> include a question.
+	<p>
 For specific rules depending on templates type (string, boolean,
 etc.), please read below.
 
@@ -4482,8 +4477,6 @@
     question is rather long (remember that translations are often longer
     than original versions)
 
-<item> The extended description should <strong>not</strong> include a question. 
-
 <item> Again, please avoid referring to specific interface widgets. A common
     mistake for such templates is "if you answer Yes"-type
     constructions.

Attachment: signature.asc
Description: Digital signature


--- End Message ---
--- Begin Message --- 
Source: developers-reference
Source-Version: 3.3.9

We believe that the bug you reported is fixed in the latest version of
developers-reference, which is due to be installed in the Debian FTP archive:

developers-reference-fr_3.3.9_all.deb
  to pool/main/d/developers-reference/developers-reference-fr_3.3.9_all.deb
developers-reference_3.3.9.dsc
  to pool/main/d/developers-reference/developers-reference_3.3.9.dsc
developers-reference_3.3.9.tar.gz
  to pool/main/d/developers-reference/developers-reference_3.3.9.tar.gz
developers-reference_3.3.9_all.deb
  to pool/main/d/developers-reference/developers-reference_3.3.9_all.deb



A summary of the changes between this version and the previous one is
attached.

Thank you for reporting the bug, which will now be closed.  If you
have further comments please address them to 401415@bugs.debian.org,
and the maintainer will reopen the bug report if appropriate.

Debian distribution maintenance software
pp.
W. Martin Borgert <debacle@debian.org> (supplier of updated developers-reference package)

(This message was generated automatically at their request; if you
believe that there is a problem with it please contact the archive
administrators by mailing ftpmaster@debian.org)


-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

Format: 1.7
Date: Thu, 28 Feb 2008 10:16:40 +0000
Source: developers-reference
Binary: developers-reference developers-reference-fr
Architecture: source all
Version: 3.3.9
Distribution: unstable
Urgency: low
Maintainer: Debian Documentation Project <debian-doc@lists.debian.org>
Changed-By: W. Martin Borgert <debacle@debian.org>
Description: 
 developers-reference - guidelines and information for Debian developers
 developers-reference-fr - guidelines and information for Debian developers, in French
Closes: 356720 373816 374220 384178 391023 401415 405453 405818 410159 412757 413320 414291 419507 420540 422750 427832 428846 445642
Changes: 
 developers-reference (3.3.9) unstable; urgency=low
 .
   [ Andreas Barth ]
   * Packaging changes:
     - bump standards-version to 3.7.3 (no change)
     - fix debian/copyright
     - move debhelper to Build-Depends.
     - add pdf for French version.
   * Document changes to stable release management. Closes: #414291
   * Debconf error templates no longer discouraged. Thanks,
     Christian Perrier. Closes: #427832
   * Keyring now uses RT. Closes: #428846
   * Document -dbg-packages within BPs. Thanks, Joey Hess. Closes: #420540
   * NMUs now also close bugs. Thanks, Lucas Nussbaum. Closes: #419507
   * Fix documentation about gender neutral. Closes: #384178
   * Fix typo. Closes: #405453
   * More details on how to write documentation. Thanks, Josh Triplett.
     Closes: #422750
   * Add XS-Vcs-*. Thanks to Stefano Zacchiroli. Closes: #391023
   * Small brushup to debconf description. Thanks, Thomas Huriaux.
     Closes: #401415
   * Document Team-Maintainence better. Thanks, Lucas Nussbaum.
     Closes: #410159
   * Add link to more removal ressources. Thanks, Adam D. Barratt,
     Justin Pryzby. Closes: #412757, #356720
   * Repacking source packages need to be documented in copyright.
     Thanks, Russ Allbery. Closes: #413320
   * Better describe version of debian native packages NMUs. Closes: #405818
   * Source, HTML and text are now encoded in UTF-8. Thanks, Jörg Sommer.
     Closes: #373816
   * Source is now DocBook XML instead of debiandoc. Closes: #374220
 .
   [ Raphael Hertzog ]
   * Add a link to enrico's excellent Debian Community Guidelines.
   * Recommend the use of DSA's request tracker instead of mailing them.
   * Remove reference to #debian-sf, #debian-bsd which don't exist anymore. Put
     a reference to #debian-dpkg instead.
   * Remove all stuff concerning non-US.
   * Update information concerning Alioth.
   * Update information concerning the Package Tracking System.
   * Mention Alioth as the main resource for VCS repositories and deprecate
     cvs.debian.org.
   * Remove XS- prefix for Vcs-* fields since dpkg now supports them.
   * Document the Homepage field. Thanks, Christian Perrier. Closes:
     #445642
   * Add Vcs-Svn and Vcs-Browser fields pointing to the new SVN
     repository.
Files: 
 f3b140613997b6255f00cff2e0652485 866 doc optional developers-reference_3.3.9.dsc
 feb746b3608063b4994472866f39709e 871922 doc optional developers-reference_3.3.9.tar.gz
 4f4292fe8246f1338115266a7ff61349 660596 doc optional developers-reference_3.3.9_all.deb
 72e49ae1cd934ebaaf411beb7852214d 663386 doc optional developers-reference-fr_3.3.9_all.deb

-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.6 (GNU/Linux)

iD8DBQFHxpwF+xM0OFfj6IgRAqdfAJwNNiihs+QYn2KuGIFWNz4UbU0rYACZATqP
VNJKCAzzbxObVoiWSiSsPDY=
=9TZe
-----END PGP SIGNATURE-----

--- End Message ---
Reply to: