[Pkg-ruby-extras-maintainers] better ruby-extconf-rb.mk documentation

[Tomas Pospisek's Mailing Lists]

Hello Rubistas

I hope I've successfully packaged libposixlock-ruby [1] and learned a bit 
about CDBS thanks to your docu [2]. Thanks for that.

Now allthough in the end CDBS style ruby library packaging is not so mind 
boggling, doing it for the first time I spent a lot of time falling into 
obscure potholes.

I'd suggest you put in a reference to some packages that you consider 
could serve as a reference for newbies. Thus:

 	apt-get source lib<reference>-ruby

would give the newbie a place to start.

I'd suggest something like this:

------------------------------------------------------------------------
$ diff -u 30.cdbs.en.page.orig 30.cdbs.en.page
--- 30.cdbs.en.page.orig        2006-05-03 23:43:45.000000000 +0200
+++ 30.cdbs.en.page     2006-05-03 23:47:57.000000000 +0200
@@ -24,6 +24,8 @@
  include /usr/share/cdbs/1/rules/debhelper.mk
  include /usr/share/ruby-pkg-tools/1/class/ruby-setup-rb.mk</code></pre>

+ at libbreakpoint-ruby@ is an example of a @setup.rb@ based Debian package.
+
  For @extconf.rb@ it would look like this:

  <pre><code>#!/usr/bin/make -f
@@ -33,6 +35,9 @@
  include /usr/share/cdbs/1/rules/debhelper.mk
  include /usr/share/ruby-pkg-tools/1/class/ruby-extconf-rb.mk</code></pre>

+You can have a look at @libgpgme-ruby@ to see how an @extconf.rb@ based
+package can be built.
+
  Note that it is still possible to configure and override the behaviour of
  the class and debhelper.  No control is lost.  For more information about
  how to use the class, see the "CDBS
------------------------------------------------------------------------

Thanks,
*t

PS: libposixlock-ruby is currently being digested by Debian's
     ftpmasters and by autobuilder.

[1] http://raa.ruby-lang.org/project/posixlock/
[2] http://pkg-ruby-extras.alioth.debian.org/ruby-pkg-tools/cdbs.html

--
-----------------------------------------------------------
   Tomas Pospisek
   http://sourcepole.com -  Linux & Open Source Solutions
-----------------------------------------------------------