gem2deb(1) [debian man page]
GEM2DEB(1) GEM2DEB(1) NAME
gem2deb - converts Rubygems' .gem file into Debian package SYNOPSIS
gem2deb [OPTIONS] GEMNAME (to download the gem with gem fetch) gem2deb [OPTIONS] GEMFILE (to use a local .gem file) DESCRIPTION
gem2deb converts the gem into a Debian source package, and then will attempt to build it. The process is made of several steps. First, gem2deb converts the gem file to a tar.gz archive containing a metadata.yml file with the Gem specification. This is equivalent to what gem2tgz does. Then, gem2deb unpacks the tar.gz archive and prepares a Debian source package, guess many of the defaults from the files included in the archive, or the Gem specification. This is equivalent to what dh-make-ruby does. gem2deb cannot determine all parameters for obvious reasons. It is recommended to search for the "FIXME" string in the debian/ directory. The generated Debian source package uses dh_ruby to build the package. Finally, gem2deb tries to build the source and binary packages using dpkg-buildpackage. OPTIONS
-t, --only-tarball Stop after creating the tar.gz archive. -s, --only-source-dir Stop after preparing the Debian source package directory (do not attempt to build the package). -S, --only-debian-source Only build a Debian source package (do not build binary packages). -p PACKAGE, --package PACKAGE Specify package name (default: ruby-*). Passed to dh-make-ruby. See dh-make-ruby(1). --ruby-versions VERSIONS Ruby versions to build the package for (default: all). Passed to dh-make-ruby. See dh-make-ruby(1). -h, --help Displays gem2deb usage information. -v, --version Displays gem2deb version information. HOW THE .GEM ->; .TGZ CONVERSION WORKS A gem named 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: Files It contains all the files the gem contains. Metadata It contains the gem metadata ends up in a file named ``metadata.yml`` inside the mygem-0.1.0 directory. SEE ALSO
dh_ruby(1) COPYRIGHT AND AUTHORS
Copyright (c) 2011, Lucas Nussbaum <lucas@debian.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/>. 2012-03-06 GEM2DEB(1)
Check Out this Related Man Page
DH-MAKE-PEAR(1) dh-make-pear User Manual DH-MAKE-PEAR(1) NAME
dh-make-pear - Create debian source packages from pear modules SYNOPSIS
dh-make-pear [--help ] [--version ] [--rename ] [--arch any | all] [--state STATE] [--depends DEPENDS] [--maintainer MAINTAINER] [--prefix PREFIX] [--templatedir TEMPLATEDIR] [PACKAGE] DESCRIPTION
This manual page documents briefly the dh-make-pear command. dh-make-pear creates the files required to build a debian source package from a PHP extension as it is distributed through PEAR. The last parameter passed to dh-make-pear can be either the .tgz archive containing the php extension or the name of the extension. In the second case dh-make-pear will first download the archive from http://pear.php.net. If dh-make-pear downloads the archive itself, it will always take the most recent version. dh-make-pear will by default create a directory named php-<pear-package-name> which will contain the debian files and the unpacked files from the extension. It will also create a symlink php-<pear-package-name>_<version>.orig.tar.gz pointing towards the original source. After creating the files you can go into then new directory and build the debian package with dpkg-buildpackage -rfakeroot. dh-make-pear tries to extract as much information about the package from the file package.xml which is part of the pear extension. Debian source packages created by dh-make-pear can later easily be updated with uscan. OPTIONS
These programs follow the usual GNU command line syntax, with long options starting with two dashes (`-'). A summary of options is included below. For a complete description, see the Info files. -h --help Show summary of options. -v --version Show version of program. --rename Do not link orig.tar.gz but move the source into .orig.tar.gz. --arch Set architecture of created debian source package to 'any' or 'all'. Defaults to 'all'. --state Set preferred state for downloaded package. Defaults to 'stable'. --depends Adds more packages to Depends: beside php-pear. --prefix Sets prefix of debian source package name. Each name ends in '<pear-package-name>'. Defaults to 'php-'. --maintainer Explicitly sets the maintainer. In most cases it will be propperly guessed by reading some of the environment variables. --templatedir Use a different directory with templates for the debian files. Defaults to /usr/share/dh-make-php/pear.template. ENVIRONMENT
DEBFULLNAME - get the real name of the maintainer LOGNAME or USER - get the username DEBEMAIL or EMAIL - get the email address of the user SEE ALSO
dh-make-pecl (1). AUTHOR
UWE STEINMANN <steinm@debian.org> Wrote this manpage for the Debian system. COPYRIGHT
Copyright (C) 2004-2010 Uwe Steinmann This manual page was written for the Debian system (and may be used by others). Permission is granted to copy, distribute and/or modify this document under the terms of the GNU General Public License, Version 2 or (at your option) any later version published by the Free Software Foundation. On Debian systems, the complete text of the GNU General Public License can be found in /usr/share/common-licenses/GPL. dh-make-pear 09/01/2010 DH-MAKE-PEAR(1)