[DRE-commits] [SCM] ruby-policy.git branch, master, updated. f7860523d2bf0b2b089107aeacf2490444e55996

[Vincent Fourmond]

The following commit has been merged in the master branch:
commit f7860523d2bf0b2b089107aeacf2490444e55996
Author: Vincent Fourmond <fourmond at debian.org>
Date:   Wed Jun 22 17:46:24 2011 +0200

    Clarify load path order for interpreters

diff --git a/ruby-policy.xml b/ruby-policy.xml
index 09c811c..2595ab8 100644
--- a/ruby-policy.xml
+++ b/ruby-policy.xml
@@ -201,6 +201,36 @@
             </listitem>
           </itemizedlist>
         </para>
+        <para>
+          The load paths &must; be searched for Ruby libraries in the
+          following order:
+          <itemizedlist>
+            <listitem>
+              <para>
+                The <emphasis>site directory</emphasis>, where files
+                installed by local administrator (typically a
+                subdirectory of <filename>/usr/local</filename>;
+              </para>
+            </listitem>
+            <listitem>
+              <para>
+                The aforementioned subdirectories in
+                <filename>/usr/lib/vendor_ruby/</filename>.
+              </para>
+            </listitem>
+            <listitem>
+              <para>
+                And, finally, the system directories, where the system
+                libraries bundled with the interpreter are installed
+                (the ruby standard library).
+              </para>
+            </listitem>
+          </itemizedlist>
+        </para>
+        <para>
+          The aim of this setup is to allow the possibility for users
+          and packagers to override parts of the standard library.
+        </para>
       </sect2>
 
     </sect1>

-- 
ruby-policy.git