vrms(1) [debian man page]

VRMS(1) 						      General Commands Manual							   VRMS(1)

NAME

       vrms - report of installed non-free software

SYNOPSIS

       vrms [OPTION] ...

DESCRIPTION

       This program began as an attempt to create a "virtual Richard M. Stallman" for Debian GNU/Linux.  Thus the choice of name.

       This program analyzes the currently-installed package list on a Debian GNU/Linux system, and reports the non-free and contrib packages that
       are currently installed to stdout.  In some cases, such as regarding documentation licensed under the GNU Free Documentation  License  with
       invariant  sections,  the  opinions of Richard M.  Stallman and the Debian project have diverged since this program was originally written.
       In such cases, this program follows the definition of freedom embodied in the Debian Free Software Guidelines.

       The packages in the non-free tree have restrictions on their use and/or distribution which cause them to fail to  meet  the  terms  of  the
       Debian  Free Software Guidelines included as part of the Debian Social Contract.  However, some are sufficiently useful that their presence
       is often tolerated by Debian users despite their licensing.

       The packages in the contrib tree are themselves free software but have some dependency on non-free software for their use  that	make  them
       worthy of reporting so that their use can also be consciously considered.

       Richard	is  the most vocal among us on the issue of software morality, and we agree with Richard that Debian users should have an easy way
       to know when they are running non-free software on their systems.  This program is our attempt to fill that need.

OPTIONS

       All options can be prefixed with -- (eg: --noexplain) to turn them off.

       -q, --quiet
	      Do nothing if there are no non-free packages installed.

       -e, --explain
	      Give a brief explanation of why each package is non-free, if available. This is the default.

       -s, --sparse
	      Just output a list of non-free packages.

       --reason-dir=DIR
	      Use DIR as the reason directory, instead of /usr/share/vrms/reasons/.

       -h, --help
	      Display help.

       -d, --debug
	      Generate debugging information.

FILES

       /usr/share/vrms/reasons
	      Default source of explanations for why packages are non-free.

HISTORY

       This program was written by Bdale Garbee and Bill Geddes for the Debian GNU/Linux system, in response to an open  discussion  with  Richard
       Stallman about the issues surrounding the availability/desirability of the 'non-free' package tree in Debian.

								A Cute Little Hack							   VRMS(1)

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)