[DRE-commits] r4635 - trunk/libinline-ruby/debian

[Paul van Tilburg]

Author: paulvt
Date: 2010-02-14 12:41:14 +0000 (Sun, 14 Feb 2010)
New Revision: 4635

Added:
   trunk/libinline-ruby/debian/README.debian
   trunk/libinline-ruby/debian/libinline-ruby.examples
Removed:
   trunk/libinline-ruby/debian/libinline-ruby1.8.docs
   trunk/libinline-ruby/debian/libinline-ruby1.8.examples
Modified:
   trunk/libinline-ruby/debian/changelog
Log:
* New upstream release. 
* debian/control: bumped standards-version to 3.8.4; no changes required.
* debian/README.Debian:
  - Added to explain inline caching and some issues, copied from
    libimage-science-ruby, courtesy of Gunnar Wolf (closes: #499859).
* debian/libinline-ruby{1.8,}.examples: moved the examples to the
  libinline-ruby package. 

Added: trunk/libinline-ruby/debian/README.debian
===================================================================
--- trunk/libinline-ruby/debian/README.debian	                        (rev 0)
+++ trunk/libinline-ruby/debian/README.debian	2010-02-14 12:41:14 UTC (rev 4635)
@@ -0,0 +1,39 @@
+RubyInline is a Ruby module that allows for easily embedding and on-the-fly
+compiling C code in Ruby modules.
+
+Although it will work right away on most typical situations, there are
+a couple of catches you should keep in mind:
+
+- To minimize startup times, the inlined C code is cached. This means,
+  any user who calls this module in his Ruby code will get a directory
+  called ".ruby_inline" on his home directory. Inside this directory,
+  Inline will store the C code to be compiled and the compiled
+  objects. The directory can be safely purged, as it will be
+  regenerated as needed.
+
+- You can set up the environment variable INLINEDIR to specify a
+  different directory, i.e., to cope with the cases where the current
+  user has no rights to write on his own directory (which is often the
+  case when using this module for Web-facing application servers). You
+  can safely point it to a randomized temporary directory, as in:
+
+  $ su - nobody -c 'export INLINEDIR=$(mktemp -d); \
+         ruby_inline_using_application; \
+         rm -rf $INLINEDIR'
+
+  Of course, you would replace the call to Ruby to the startup for
+  your application. There will be a slight time penalty upon
+  initialization, as this will compile anew the code each time it is
+  started, but will allow you to work with users unable to work in
+  their home directories.
+
+- It might also be a good idea, specially on slower systems, to set
+  INLINEDIR to a fixed location, i.e. to create user-owned
+  /var/lib/inline/$(whoami) directories. This would avoid the
+  recompilation penalty - You should just remember to purge the
+  directory should you stop using this module.
+
+Of course, for most use cases, the default .ruby_inline directory will
+serve you well.
+
+ -- Gunnar Wolf <gwolf at debian.org>, Mon, 22 Sep 2008 18:16:12 -0500

Modified: trunk/libinline-ruby/debian/changelog
===================================================================
--- trunk/libinline-ruby/debian/changelog	2010-02-13 09:53:48 UTC (rev 4634)
+++ trunk/libinline-ruby/debian/changelog	2010-02-14 12:41:14 UTC (rev 4635)
@@ -1,3 +1,15 @@
+libinline-ruby (3.8.4-1) unstable; urgency=low
+
+  * New upstream release. 
+  * debian/control: bumped standards-version to 3.8.4; no changes required.
+  * debian/README.Debian:
+    - Added to explain inline caching and some issues, copied from
+      libimage-science-ruby, courtesy of Gunnar Wolf (closes: #499859).
+  * debian/libinline-ruby{1.8,}.examples: moved the examples to the
+    libinline-ruby package. 
+
+ -- Paul van Tilburg <paulvt at debian.org>  Sun, 14 Feb 2010 13:38:20 +0100
+
 libinline-ruby (3.8.3-3) unstable; urgency=low
 
   * Removed remaining unnecessary Gem usage (Closes: #557534)

Added: trunk/libinline-ruby/debian/libinline-ruby.examples
===================================================================
--- trunk/libinline-ruby/debian/libinline-ruby.examples	                        (rev 0)
+++ trunk/libinline-ruby/debian/libinline-ruby.examples	2010-02-14 12:41:14 UTC (rev 4635)
@@ -0,0 +1,4 @@
+debian/helloworld_example.rb
+tutorial/*
+demo/*
+example*.rb

Deleted: trunk/libinline-ruby/debian/libinline-ruby1.8.docs
===================================================================
--- trunk/libinline-ruby/debian/libinline-ruby1.8.docs	2010-02-13 09:53:48 UTC (rev 4634)
+++ trunk/libinline-ruby/debian/libinline-ruby1.8.docs	2010-02-14 12:41:14 UTC (rev 4635)
@@ -1 +0,0 @@
-README.txt

Deleted: trunk/libinline-ruby/debian/libinline-ruby1.8.examples
===================================================================
--- trunk/libinline-ruby/debian/libinline-ruby1.8.examples	2010-02-13 09:53:48 UTC (rev 4634)
+++ trunk/libinline-ruby/debian/libinline-ruby1.8.examples	2010-02-14 12:41:14 UTC (rev 4635)
@@ -1,4 +0,0 @@
-debian/helloworld_example.rb
-tutorial/*
-demo/*
-example*.rb