[DRE-commits] r5930 - in trunk: . ruby-pkg-tools/bin ruby-pkg-tools/debian

[Antonio Terceiro]

Author: terceiro-guest
Date: 2010-10-16 23:40:55 +0000 (Sat, 16 Oct 2010)
New Revision: 5930

Removed:
   trunk/gem2tgz/
Modified:
   trunk/ruby-pkg-tools/bin/gem2tgz
   trunk/ruby-pkg-tools/debian/changelog
   trunk/ruby-pkg-tools/debian/ruby-pkg-tools.manpages
   trunk/ruby-pkg-tools/debian/rules
Log:
Finishing move of gem2tgz to ruby-pkg-tools



Modified: trunk/ruby-pkg-tools/bin/gem2tgz
===================================================================
--- trunk/ruby-pkg-tools/bin/gem2tgz	2010-10-16 23:30:57 UTC (rev 5929)
+++ trunk/ruby-pkg-tools/bin/gem2tgz	2010-10-16 23:40:55 UTC (rev 5930)
@@ -1,4 +1,4 @@
-#! /usr/bin/ruby1.8
+#!/usr/bin/ruby
 #
 # Copyright © 2010, Antonio Terceiro <terceiro at softwarelivre.org>
 # 
@@ -65,3 +65,75 @@
 tarball = ARGV[1] || gem.gsub(/\.gem$/, '.tar.gz')
 
 Gem2Tgz.convert!(gem, tarball)
+
+__END__
+=head1 NAME
+
+gem2tgz - converts Rubygems' .gem file into tarballs
+
+=head1 USAGE
+
+gem2tgz [OPTIONS] GEM [TARBALL]
+
+=head1 DESCRIPTION
+
+B<gem2tgz> will convert the .gem file I<GEM> into a tarball named I<TARBALL>.
+If I<TARBALL> is omitted, B<gem2tgz> will try to guess the filename for the
+tarball by taking I<GEM> and replacing '.gem' with '.tar.gz'.
+
+=head1 OPTIONS
+
+=over
+
+=item --help
+
+Displays B<gem2tgz> usage information.
+
+=back
+
+=head1 HOW THE CONVERSION WORKS
+
+A gem named I<mygem-0.1.0.gem> is converted in a tarball with
+(approximately) the following steps:
+
+  mkdir mygem-0.1.0
+  cd mygem-0.1.0
+  tar xfm /absolute/path/to/mygem-0.1.0.gem
+  tar xzfm data.tar.gz
+  zcat metadata.gz > metadata.yml
+  rm -f data.tar.gz metadata.gz
+  cd ..
+  tar czf mygem-0.1.0.tar.gz mygem-0.1.0
+  rm -rf mygem-0.1.0
+
+The generated tarball has the following properties:
+
+=over
+
+=item Files
+
+It contains all the files the gem contains.
+
+=item Metadata
+
+It contains the gem metadata ends up in a file named ``metadata.yml`` inside the I<mygem-0.1.0> directory.
+
+=back
+
+=head1 COPYRIGHT AND AUTHORS
+
+Copyright (c) 2010, Antonio Terceiro <terceiro at softwarelivre.org>
+
+This program is free software: you can redistribute it and/or modify
+it under the terms of the GNU General Public License as published by
+the Free Software Foundation, either version 3 of the License, or
+(at your option) any later version.
+
+This program is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+GNU General Public License for more details.
+
+You should have received a copy of the GNU General Public License
+along with this program.  If not, see <http://www.gnu.org/licenses/>.
+

Modified: trunk/ruby-pkg-tools/debian/changelog
===================================================================
--- trunk/ruby-pkg-tools/debian/changelog	2010-10-16 23:30:57 UTC (rev 5929)
+++ trunk/ruby-pkg-tools/debian/changelog	2010-10-16 23:40:55 UTC (rev 5930)
@@ -14,8 +14,12 @@
   * Removing Thierry Reding from the group, as per mia-teammaint request
     (Closes: #572542)
 
- -- Gunnar Wolf <gwolf at debian.org>  Thu, 29 Jul 2010 15:32:50 -0400
+  [ Antonio Terceiro ]
+  * Added gem2tgz utility to convert Rubygems's .gem files into proper source
+    tarballs.
 
+ -- Antonio Terceiro <terceiro at softwarelivre.org>  Sat, 16 Oct 2010 20:39:58 -0300
+
 ruby-pkg-tools (0.17) unstable; urgency=low
 
   [ Marc Dequènes (Duck) ]

Modified: trunk/ruby-pkg-tools/debian/ruby-pkg-tools.manpages
===================================================================
--- trunk/ruby-pkg-tools/debian/ruby-pkg-tools.manpages	2010-10-16 23:30:57 UTC (rev 5929)
+++ trunk/ruby-pkg-tools/debian/ruby-pkg-tools.manpages	2010-10-16 23:40:55 UTC (rev 5930)
@@ -1 +1 @@
-man/dh_rdoc.1
+man/*

Modified: trunk/ruby-pkg-tools/debian/rules
===================================================================
--- trunk/ruby-pkg-tools/debian/rules	2010-10-16 23:30:57 UTC (rev 5929)
+++ trunk/ruby-pkg-tools/debian/rules	2010-10-16 23:40:55 UTC (rev 5930)
@@ -12,6 +12,7 @@
 
 build/ruby-pkg-tools::
 	pod2man ./bin/dh_rdoc > ./man/dh_rdoc.1
+	pod2man ./bin/gem2tgz > ./man/gem2tgz.1
 
 clean::
-	rm -f man/dh_rdoc.1
+	rm -f man/*.1