Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Ruby's Classic Site Installer
branch: master

This branch is 134 commits behind rubyworks:master

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
.config/syckle
bin
doc
lib
meta
site
task
test
work
.gitignore
COPYING
HISTORY
README.rdoc
setup.rb

README.rdoc

Ruby Setup

http://setup.rubyforge.org

INTRODUCTION

Every Rubyist is aware of Minero Aoki's ever useful setup.rb script. It's how most of us used to install our ruby programs before RubyGems came along. And it's still mighty useful in certain scenarios, not the least of which is the job of the distribution package managers. Setup converts setup.rb into a stand-alone application. No longer will you need distribute setup.rb with you Ruby packages. Just instruct your users to use Setup.

IMPORTANT

There a couple very important difference between the old 3.4.1 verison of the setup.rb script and version 4.0.0 of the independent application.

  • The directory convention 'conf' has been change to 'etc'.

  • Multi-package project layouts are no longer supported.

INSTALLATION

The easy way to install is via RubyGems.

$ gem install setup

To install Setup manually you need to “boot-strap” it. This is done for you, by running the following:

$ ruby setup.rb

SYNOPSIS

To use setup.rb, a project must conform to the setup.rb standard layout.

Please see the documentation in doc/book. Note that the documentation is slightly out of sync with the latest release.

Usage is as simple as:

$ setup.rb config
$ setup.rb setup
$ setup.rb install

or

$ setup.rb all

If you later decide you want to remove the program.

$ setup.rb uninstall

Note that uninstall is made possible by the '.cache/setup/installedfiles' file that is generated by the install process. If that file is deleted than you will not be able to uninstall. (You can get around this be reinstalling first though).

You can clean up any setup products with:

$ setup.rb clean

And restore the package to it's pristine state with:

$ setup.rb distclean

Not that this last command will remove the .cache/setup/installedfiles file!

TODO LIST

  • Maybe protect 'installedfiles' from removal, even on distclean.

  • Separate compiling code into separate class.

COPYRIGHT & LICENSE

Copyright © 2002,2005 Minero Aoki

Copyright © 2008,2009 Thomas Sawyer

GNU LGPL, Lesser General Public License version 2.1.

For details of LGPL, see the file “COPYING”.

               7trans
  transfire@gmail.com
  http://tigerops.org

          Minero Aoki
  aamine@loveruby.net
http://i.loveruby.net
Something went wrong with that request. Please try again.