[Pkg-ruby-extras-maintainers] r304 - in website: . src

Lucas Nussbaum lucas-guest at costa.debian.org
Wed Jan 25 18:27:01 UTC 2006


Author: lucas-guest
Date: 2006-01-25 18:27:01 +0000 (Wed, 25 Jan 2006)
New Revision: 304

Added:
   website/src/35.policy.en.page
Modified:
   website/sync-website.sh
Log:
Added a policy proposal about package names in policy.html

Added: website/src/35.policy.en.page
===================================================================
--- website/src/35.policy.en.page	2006-01-25 17:09:16 UTC (rev 303)
+++ website/src/35.policy.en.page	2006-01-25 18:27:01 UTC (rev 304)
@@ -0,0 +1,31 @@
+---
+title: Ruby Policy
+inMenu: false
+---
+h1. Debian Ruby Policy
+
+This document SHOULD NOT be considered policy yet. It is only a support for discussion. Other documents worth reading:
+* "Debian Ruby Policy":http://pkg-ruby.alioth.debian.org/ruby-policy.html/index.html : a draft policy written by the pkg-ruby alioth team.
+* "Debian Python Policy":http://www.debian.org/doc/packaging-manuals/python-policy/ : an interesting read, since Python shares several problems with Ruby.
+
+h2. Packaging Variants
+
+There are two ways to package Ruby modules
+
+# Support only the default Ruby version
+# Support several Ruby versions
+
+h3. Support only the default Ruby version
+
+* Name you package libfoo-ruby
+* Depend on ruby (>= 1.X), ruby (<< 1.X+1) (you will trigger a conflict when the default ruby version is changed, so you will have to provide a new version ASAP, since your package will block the upgrade of ruby)
+
+h3. Support several Ruby versions
+
+* Create a package libfoo-ruby which depends on libfoo-ruby1.X (1.X being the default ruby version)
+* Create libfoo-ruby1.X, libfoo-ruby1.Y for each ruby version you want to support
+
+h2. Documentation and examples
+
+* If the documentation for your library is small enough, put in in libfoo-ruby (even if you are supporting several ruby versions)
+* If the documentation is too big, provide it in libfoo-ruby-doc, and make all other packages suggest libfoo-ruby-doc.

Modified: website/sync-website.sh
===================================================================
--- website/sync-website.sh	2006-01-25 17:09:16 UTC (rev 303)
+++ website/sync-website.sh	2006-01-25 18:27:01 UTC (rev 304)
@@ -1,4 +1,11 @@
 #!/bin/bash
 
+# needed to create files with the correct modes
+umask 022
 LC_ALL= webgen && rsync -avP output/ \
   alioth.debian.org:/var/lib/gforge/chroot/home/groups/pkg-ruby-extras/htdocs/
+
+# add an entry in ~/.ssh/config with :
+# Host alioth.debian.org
+#     User lucas-guest or whatever you want
+




More information about the pkg-ruby-extras-maintainers mailing list