[DRE-commits] [SCM] Debian Ruby packaging policy branch, master, updated. 5995b388ae92508fa0588b4c472de6b32b1bb3e6

[Antonio Terceiro]

The following commit has been merged in the master branch:
commit 5995b388ae92508fa0588b4c472de6b32b1bb3e6
Author: Antonio Terceiro <terceiro at softwarelivre.org>
Date:   Mon May 9 12:00:17 2011 -0700

    Document how to handle shebangs and dependencies

diff --git a/ruby-policy.xml b/ruby-policy.xml
index 2371a99..5a225b2 100644
--- a/ruby-policy.xml
+++ b/ruby-policy.xml
@@ -45,6 +45,15 @@
         </authorblurb>
       </author>
       <author>
+        <surname>Terceiro</surname>
+        <firstname>Antonio</firstname>
+        <authorblurb>
+          <para>
+            <email>terceiro at softwarelivre.org</email>
+          </para>
+        </authorblurb>
+      </author>
+      <author>
         <othername>the Debian Ruby mailing list</othername>
         <authorblurb>
           <para>
@@ -262,12 +271,23 @@
       </para>
 
       <sect2>
-        <title>Shebang</title>
+        <title>Handling the different Ruby interpreters</title>
+        <para>
+          If the program is supposed to work correcly with any Ruby
+          interpreter, than it &must; have a <literal>#!/usr/bin/ruby</literal>
+          shebang, and &must; depend on
+          <literal>ruby |ruby-interpreter</literal>.
+          This &should; be the default for most packages, since it will ease
+          the transition to new default versions of the Ruby interpreter.
+        </para>
         <para>
-          All the programs &must; have a <literal>#!
-          /usr/bin/ruby1.8</literal> shebang, unless they rely on
-          implementation specific libraries, in which case the shebang
-          should reflect these requirements.
+          If the program is supposed to work with a specific Ruby interpreter,
+          then it &must; have a
+          <literal>#!/usr/bin/rubyX.Y</literal>
+          shebang and &must; depend on the specific package for that
+          interpreter. For example, a program that only works with Ruby 1.9.1
+          would have a <literal>#!/usr/bin/ruby1.9.1</literal> shebang and
+          depend on <literal>ruby1.9.1</literal>.
         </para>
       </sect2>
     </sect1>

-- 
Debian Ruby packaging policy