[DRE-commits] [SCM] Debian Ruby packaging policy branch, master, updated. 178cb05e15aabb442d31c7bb5594886d1ccd3de6

[Antonio Terceiro]

The following commit has been merged in the master branch:
commit 178cb05e15aabb442d31c7bb5594886d1ccd3de6
Author: Antonio Terceiro <terceiro at softwarelivre.org>
Date:   Fri May 13 11:18:32 2011 -0700

    Major review of the section on interpreters

diff --git a/ruby-policy.xml b/ruby-policy.xml
index 987e58a..9c9c253 100644
--- a/ruby-policy.xml
+++ b/ruby-policy.xml
@@ -139,17 +139,39 @@
       </para>
 
       <para>
-        Only one interpreter &may; provide a
-        <literal>/usr/bin/ruby</literal> symlink to its main
-        executable. This interpreter is said to be the default Ruby
-        interpreter. At the time of the writing of this policy, it is
-        <literal>ruby1.8</literal>, but that may change in the
-        future.
+        Interpreters &may; provide an alternatives entry for
+        <literal>/usr/bin/ruby</literal>, so that users can choose one of the
+        different interpreter implementations to provide the
+        <literal>ruby</literal> program. This alternatives entry must have as
+        slaves entries for the following programs: <literal>erb</literal>,
+        <literal>testrb</literal>, <literal>irb</literal>,
+        <literal>rdoc</literal> and <literal>ri</literal>, as well as the
+        corresponding manual pages for all of those programs, including
+        <literal>ruby</literal>.
       </para>
 
       <para>
-        All Ruby interpreters &must; provide the
-        <literal>ruby-interpreter</literal> virtual package.
+        Interpreter maintainers &may; use the <literal>ruby1.8</literal> and
+        <literal>ruby1.9.1</literal> packages as an example of the alternatives
+        system handling for Ruby interpreters.
+      </para>
+
+      <para>
+        At the time of the writing of this policy, the default interpreter is
+        <literal>ruby1.8</literal>. This means that by default
+        <literal>/usr/bin/ruby</literal> points to
+        <literal>/usr/rin/rub1.8</literal>. Other interpreters &must; not
+        install alternatives entries with priority higher than
+        <literal>50</literal> without first having a) a consensus about that in
+        the <literal>debian-ruby</literal> mailing list and b) a new version of
+        this policy uploaded to <literal>unstable</literal> pointing out a new
+        default interpreter.
+      </para>
+
+      <para>
+        Ruby interpreters &may; provide the <literal>ruby-interpreter</literal>
+        virtual package, if their maintainers consider that the implementation
+        is mature enough to support most Ruby software available.
       </para>
 
       <sect2>

-- 
Debian Ruby packaging policy