Amended the section about Prompting in maintainer scripts. Added a

Author: srivasta
Date: 2003/03/21 20:32:14
Amended the section about Prompting in maintainer scripts. Added a
footnotre (quoting from the jargon file) to explain what "by hand"
means in a computer context.  closes: Bug#184507

git-archimport-id: srivasta@debian.org--etch/debian-policy--devel--3.0--patch-208

diff --git a/debian/changelog b/debian/changelog
index 2631ac2380d11be1f3d5dd1e3c8adc43e468fcf8..da62e60905d6f5b5f48224438e0bfb008ea23734 100644 (file)
--- a/debian/changelog
+++ b/debian/changelog
@@ -12,6 +12,9 @@ debian-policy (3.5.9.1) unstable; urgency=low
     since people using the old URL were redirected to auric anyway).
                                                              closes: Bug#184518
   * Inserted the word only in the package name section.      closes: Bug#184368
+  * Amended the section about Prompting in maintainer scripts. Added a
+    footnotre (quoting from the jargon file) to explain what "by hand"
+    means in a computer context.                             closes: Bug#184507
 
  -- 
 

diff --git a/policy.sgml b/policy.sgml
index 0931b9db32bfb27110425a33fd6ae3c903de3dbc..f2de5bad9ab21639475d0f24128956c44ea866cd 100644 (file)
--- a/policy.sgml
+++ b/policy.sgml
@@ -1104,14 +1104,21 @@
            <heading>Prompting in maintainer scripts</heading>
            <p>
              Package maintainer scripts may prompt the user if
-             necessary. Prompting may be accomplished by hand, or by
-             communicating with a program, such as
-             <prgn>debconf</prgn>, which conforms to the Debian
-             Configuration management specification, version 2 or
-             higher.  These are included in the
+             necessary. Prompting may be accomplished by
+             hand<footnote>
+               <p>From the Jasrgon file: by hand 2. By extension,
+                 writing code which does something in an explicit or
+                 low-level way for which a presupplied library
+                 (<em>debconf, in this instance</em>) routine ought
+                 to have been available.</p>
+             </footnote> (but this is deprecated), or by
+             communicating though a program, which conforms to the
+             Debian Configuration management specification, version 2
+             or higher (such as <prgn>debconf</prgn>).  Thiss
+             specification is included in the
              <file>debconf_specification</file> files in the
-             <package>debian-policy</package> package.
-             You may also find this file on the FTP site
+             <package>debian-policy</package> package.  You may also
+             find this file on the FTP site
              <ftpsite>ftp.debian.org</ftpsite> in
              <ftppath>/debian/doc/package-developer/debconf_specification.txt.gz</ftppath>
              or on your local mirror.<footnote>