Suggest checkbashisms or posh rather than dash to check scripts

* Suggest checkbashisms from devscripts or the posh shell for checking
  whether /bin/sh scripts are Policy-compliant rather than recommending
  dash.  Thanks, Raphael Geissert.  (Closes: #490604)

diff --git a/debian/changelog b/debian/changelog
index d2704cad9e0cf91456e3bb9842331d17646a898c..96eb8f9bbd5d28229f2689d9e72f826b571bf0af 100644 (file)
--- a/debian/changelog
+++ b/debian/changelog
@@ -6,6 +6,9 @@ debian-policy (3.9.3.1) UNRELEASED; urgency=low
     Also mention that the Files pattern syntax is the same as fnmatch(3)
     and GNU find -path without [] patterns.  Thanks, Jonathan Nieder and
     Ben Finney.
+  * Suggest checkbashisms from devscripts or the posh shell for checking
+    whether /bin/sh scripts are Policy-compliant rather than recommending
+    dash.  Thanks, Raphael Geissert.  (Closes: #490604)
   * Install the HTML version of upgrading-checklist in the policy.html
     directory as upgrading-checklist.html so that it can be deployed on
     www.debian.org in a way that will allow links to Policy sections to

diff --git a/policy.sgml b/policy.sgml
index 9e822e27fbdf699eefd173fa9c9907f02ad04995..3fcae7589b112d313dd0576d4dcdb080b8a63c1a 100644 (file)
--- a/policy.sgml
+++ b/policy.sgml
@@ -7968,10 +7968,12 @@ fname () {
        <p>
          You may wish to restrict your script to SUSv3 features plus the
          above set when possible so that it may use <file>/bin/sh</file>
-         as its interpreter. If your script works with <prgn>dash</prgn>
-         (originally called <prgn>ash</prgn>), it probably complies with
-         the above requirements, but if you are in doubt, use
-         <file>/bin/bash</file>.
+         as its interpreter.  Checking your script
+         with <prgn>checkbashisms</prgn> from
+         the <package>devscripts</package> package or running your script
+         with <prgn>posh</prgn> may help uncover violations of the above
+         requirements.  If in doubt whether a script complies with these
+         requirements, use <file>/bin/bash</file>.
        </p>
 
        <p>