setup 4.0.0

data/HISTORY

@@ -0,0 +1,7 @@
+= RELEASE HISTORY
+
+== 4.0.0 // 2008-08-15
+
+* Intial release.
+* This is a conversion of Minero Aoki's setup.rb into a stand alone application.
+

data/MANIFEST

@@ -0,0 +1,231 @@
+doc
+doc/manual
+doc/manual/doc.en
+doc/manual/doc.en/devel.html
+doc/manual/doc.en/usage.html
+doc/manual/doc.en/index.html
+doc/manual/doc.en/hookapi.html
+doc/manual/doc.en/news.html
+doc/manual/doc.en/metaconfapi.html
+doc/manual/doc.ja
+doc/manual/doc.ja/devel.html
+doc/manual/doc.ja/usage.html
+doc/manual/doc.ja/index.html
+doc/manual/doc.ja/hookapi.html
+doc/manual/doc.ja/news.html
+doc/manual/doc.ja/metaconfapi.html
+doc/rdoc
+doc/rdoc/fr_file_index.html
+doc/rdoc/classes
+doc/rdoc/classes/Errno.html
+doc/rdoc/classes/Setup.html
+doc/rdoc/classes/Errno
+doc/rdoc/classes/Errno/ENOTEMPTY.html
+doc/rdoc/classes/Setup
+doc/rdoc/classes/Setup/ConfigTable.html
+doc/rdoc/classes/Setup/Installer
+doc/rdoc/classes/Setup/Installer/Shebang.html
+doc/rdoc/classes/Setup/Command.html
+doc/rdoc/classes/Setup/Installer.html
+doc/rdoc/classes/SetupError.html
+doc/rdoc/classes/File.html
+doc/rdoc/rdoc-style.css
+doc/rdoc/files
+doc/rdoc/files/README.html
+doc/rdoc/files/METADATA.html
+doc/rdoc/files/lib
+doc/rdoc/files/lib/setup
+doc/rdoc/files/lib/setup/config_rb.html
+doc/rdoc/files/lib/setup/rake_rb.html
+doc/rdoc/files/lib/setup/rubyver_rb.html
+doc/rdoc/files/lib/setup/command_rb.html
+doc/rdoc/files/lib/setup/build_rb.html
+doc/rdoc/files/lib/setup/install_rb.html
+doc/rdoc/files/lib/setup/error_rb.html
+doc/rdoc/files/lib/setup_rb.html
+doc/rdoc/files/NEWS.html
+doc/rdoc/files/HISTORY.html
+doc/rdoc/files/COPYING.html
+doc/rdoc/files/bin
+doc/rdoc/files/bin/setup_rb.html
+doc/rdoc/fr_class_index.html
+doc/rdoc/index.html
+doc/rdoc/created.rid
+doc/rdoc/fr_method_index.html
+doc/ri
+doc/ri/File
+doc/ri/File/dir%3f-c.yaml
+doc/ri/File/cdesc-File.yaml
+doc/ri/File/read-c.yaml
+doc/ri/SetupError
+doc/ri/SetupError/cdesc-SetupError.yaml
+doc/ri/created.rid
+doc/ri/Errno
+doc/ri/Errno/cdesc-Errno.yaml
+doc/ri/Errno/ENOTEMPTY
+doc/ri/Errno/ENOTEMPTY/cdesc-ENOTEMPTY.yaml
+doc/ri/Setup
+doc/ri/Setup/cdesc-Setup.yaml
+doc/ri/Setup/Command
+doc/ri/Setup/Command/run-c.yaml
+doc/ri/Setup/Command/run-i.yaml
+doc/ri/Setup/Command/cdesc-Command.yaml
+doc/ri/Setup/Command/help-i.yaml
+doc/ri/Setup/Installer
+doc/ri/Setup/Installer/srcfile%3f-i.yaml
+doc/ri/Setup/Installer/make-i.yaml
+doc/ri/Setup/Installer/install_dir_doc-i.yaml
+doc/ri/Setup/Installer/install_dir_lib-i.yaml
+doc/ri/Setup/Installer/distclean_dir_lib-i.yaml
+doc/ri/Setup/Installer/report_header-i.yaml
+doc/ri/Setup/Installer/binread-i.yaml
+doc/ri/Setup/Installer/clean_dir_etc-i.yaml
+doc/ri/Setup/Installer/exec_test-i.yaml
+doc/ri/Setup/Installer/srcexist%3f-i.yaml
+doc/ri/Setup/Installer/clean_dir_ext-i.yaml
+doc/ri/Setup/Installer/config_dir_etc-i.yaml
+doc/ri/Setup/Installer/remove_tree-i.yaml
+doc/ri/Setup/Installer/srcdirectories-i.yaml
+doc/ri/Setup/Installer/verbose_off-i.yaml
+doc/ri/Setup/Installer/compiles%3f-i.yaml
+doc/ri/Setup/Installer/curr_objdir-i.yaml
+doc/ri/Setup/Installer/globs2re-i.yaml
+doc/ri/Setup/Installer/rm_f-i.yaml
+doc/ri/Setup/Installer/dllext-i.yaml
+doc/ri/Setup/Installer/install_dir_etc-i.yaml
+doc/ri/Setup/Installer/exec_install-i.yaml
+doc/ri/Setup/Installer/targetfiles-i.yaml
+doc/ri/Setup/Installer/mapdir-i.yaml
+doc/ri/Setup/Installer/exec_task_traverse-i.yaml
+doc/ri/Setup/Installer/extconf-i.yaml
+doc/ri/Setup/Installer/rubyextentions-i.yaml
+doc/ri/Setup/Installer/clean_dir_doc-i.yaml
+doc/ri/Setup/Installer/open_atomic_writer-i.yaml
+doc/ri/Setup/Installer/srcdirectory%3f-i.yaml
+doc/ri/Setup/Installer/Shebang
+doc/ri/Setup/Installer/Shebang/load-c.yaml
+doc/ri/Setup/Installer/Shebang/cdesc-Shebang.yaml
+doc/ri/Setup/Installer/Shebang/parse-c.yaml
+doc/ri/Setup/Installer/Shebang/to_s-i.yaml
+doc/ri/Setup/Installer/Shebang/new-c.yaml
+doc/ri/Setup/Installer/curr_srcdir-i.yaml
+doc/ri/Setup/Installer/exec_distclean-i.yaml
+doc/ri/Setup/Installer/rm_rf-i.yaml
+doc/ri/Setup/Installer/config_dir_doc-i.yaml
+doc/ri/Setup/Installer/quiet%3f-i.yaml
+doc/ri/Setup/Installer/distclean_dir_man-i.yaml
+doc/ri/Setup/Installer/verbose%3f-i.yaml
+doc/ri/Setup/Installer/force_remove_file-i.yaml
+doc/ri/Setup/Installer/mkdir_p-i.yaml
+doc/ri/Setup/Installer/ruby-i.yaml
+doc/ri/Setup/Installer/exec_uninstall-i.yaml
+doc/ri/Setup/Installer/dive_into-i.yaml
+doc/ri/Setup/Installer/clean_dir_man-i.yaml
+doc/ri/Setup/Installer/setup_dir_lib-i.yaml
+doc/ri/Setup/Installer/diff%3f-i.yaml
+doc/ri/Setup/Installer/installation%21-i.yaml
+doc/ri/Setup/Installer/install_dir_data-i.yaml
+doc/ri/Setup/Installer/objdir_root-i.yaml
+doc/ri/Setup/Installer/distclean_dir_etc-i.yaml
+doc/ri/Setup/Installer/setup_dir_doc-i.yaml
+doc/ri/Setup/Installer/glob_select-i.yaml
+doc/ri/Setup/Installer/distclean_dir_ext-i.yaml
+doc/ri/Setup/Installer/exec_all-i.yaml
+doc/ri/Setup/Installer/get_config-i.yaml
+doc/ri/Setup/Installer/update_shebang_line-i.yaml
+doc/ri/Setup/Installer/files_of-i.yaml
+doc/ri/Setup/Installer/config_dir_bin-i.yaml
+doc/ri/Setup/Installer/noop-i.yaml
+doc/ri/Setup/Installer/install_dir_ext-i.yaml
+doc/ri/Setup/Installer/extensions-i.yaml
+doc/ri/Setup/Installer/relpath-i.yaml
+doc/ri/Setup/Installer/remove_tree0-i.yaml
+doc/ri/Setup/Installer/srcdir_root-i.yaml
+doc/ri/Setup/Installer/existfiles-i.yaml
+doc/ri/Setup/Installer/inspect-i.yaml
+doc/ri/Setup/Installer/config_dir_data-i.yaml
+doc/ri/Setup/Installer/config_dir_lib-i.yaml
+doc/ri/Setup/Installer/exec_doc-i.yaml
+doc/ri/Setup/Installer/distclean_dir_doc-i.yaml
+doc/ri/Setup/Installer/record_installation-i.yaml
+doc/ri/Setup/Installer/distclean_dir_bin-i.yaml
+doc/ri/Setup/Installer/exec_show-i.yaml
+doc/ri/Setup/Installer/hookfiles-i.yaml
+doc/ri/Setup/Installer/glob_reject-i.yaml
+doc/ri/Setup/Installer/new_shebang-i.yaml
+doc/ri/Setup/Installer/rmdir-i.yaml
+doc/ri/Setup/Installer/exec_setup-i.yaml
+doc/ri/Setup/Installer/clean_dir_bin-i.yaml
+doc/ri/Setup/Installer/config_dir_ext-i.yaml
+doc/ri/Setup/Installer/clean_dir_lib-i.yaml
+doc/ri/Setup/Installer/exec_clean-i.yaml
+doc/ri/Setup/Installer/setup_dir_bin-i.yaml
+doc/ri/Setup/Installer/setup_dir_data-i.yaml
+doc/ri/Setup/Installer/installation%3f-i.yaml
+doc/ri/Setup/Installer/install_files-i.yaml
+doc/ri/Setup/Installer/srcfile-i.yaml
+doc/ri/Setup/Installer/traverse-i.yaml
+doc/ri/Setup/Installer/install_dir_bin-i.yaml
+doc/ri/Setup/Installer/srcfiles-i.yaml
+doc/ri/Setup/Installer/install-i.yaml
+doc/ri/Setup/Installer/no_harm%3f-i.yaml
+doc/ri/Setup/Installer/directories_of-i.yaml
+doc/ri/Setup/Installer/exec_rdoc-i.yaml
+doc/ri/Setup/Installer/setup_dir_etc-i.yaml
+doc/ri/Setup/Installer/setup_dir_ext-i.yaml
+doc/ri/Setup/Installer/exec_config-i.yaml
+doc/ri/Setup/Installer/distclean_dir_data-i.yaml
+doc/ri/Setup/Installer/run_hook-i.yaml
+doc/ri/Setup/Installer/config_dir_man-i.yaml
+doc/ri/Setup/Installer/srcentries-i.yaml
+doc/ri/Setup/Installer/libfiles-i.yaml
+doc/ri/Setup/Installer/command-i.yaml
+doc/ri/Setup/Installer/extdir%3f-i.yaml
+doc/ri/Setup/Installer/set_config-i.yaml
+doc/ri/Setup/Installer/new-c.yaml
+doc/ri/Setup/Installer/install_dir_man-i.yaml
+doc/ri/Setup/Installer/clean_dir_data-i.yaml
+doc/ri/Setup/Installer/remove_file-i.yaml
+doc/ri/Setup/Installer/cdesc-Installer.yaml
+doc/ri/Setup/Installer/exec_ri-i.yaml
+doc/ri/Setup/Installer/setup_dir_man-i.yaml
+doc/ri/Setup/Installer/move_file-i.yaml
+doc/ri/Setup/ConfigTable
+doc/ri/Setup/ConfigTable/show-i.yaml
+doc/ri/Setup/ConfigTable/attr_pathlist-c.yaml
+doc/ri/Setup/ConfigTable/compiles%3f-i.yaml
+doc/ri/Setup/ConfigTable/cdesc-ConfigTable.yaml
+doc/ri/Setup/ConfigTable/%5b%5d%3d-i.yaml
+doc/ri/Setup/ConfigTable/attr_boolean-c.yaml
+doc/ri/Setup/ConfigTable/shebang%3d-i.yaml
+doc/ri/Setup/ConfigTable/env_config-i.yaml
+doc/ri/Setup/ConfigTable/load_config-i.yaml
+doc/ri/Setup/ConfigTable/installdirs%3d-i.yaml
+doc/ri/Setup/ConfigTable/initialize_defaults-i.yaml
+doc/ri/Setup/ConfigTable/extensions-i.yaml
+doc/ri/Setup/ConfigTable/extconfs-i.yaml
+doc/ri/Setup/ConfigTable/save_config-i.yaml
+doc/ri/Setup/ConfigTable/%5b%5d-i.yaml
+doc/ri/Setup/ConfigTable/attr_accessor-c.yaml
+doc/ri/Setup/ConfigTable/new-c.yaml
+doc/ri/Setup/ConfigTable/attr_pathname-c.yaml
+test
+README
+HISTORY
+METADATA
+lib
+lib/setup.rb
+lib/setup
+lib/setup/install.rb
+lib/setup/rake.rb
+lib/setup/command.rb
+lib/setup/build.rb
+lib/setup/config.rb
+lib/setup/rubyver.rb
+lib/setup/error.rb
+NEWS
+bin
+bin/setup.rb
+script
+script/install
+COPYING

data/METADATA

@@ -0,0 +1,25 @@
+---
+project   : setup
+version   : 4.0.0
+status    : beta
+released  : 2008-08-15
+
+title     : Setup
+brief     : Setup.rb Stand-alone Application
+
+author    : trans <transfire@gmail.com>
+copyright : (c) 2008 Tiger Ops
+homepage  : http://setup.rubyforge.org
+email     : tigerops-talk@rubyforge.org
+created   : 2008-08-01
+
+abstract  : >
+  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.
+

data/NEWS

@@ -0,0 +1,21 @@
+= NEWS
+
+== 4.0.0 // 2008-08-16
+
+This is the initial release of Setup. As such it is getting
+the label "betaware" until enough people put it 
+through it's paces. However, since it is predominantly
+setup.rb 3.4.1 code, and that it works to install
+itself ;) it certainly is a usable product.
+
+Please report any problems so we can fix them ASAP.
+
+Currently Setup does not support Aoki's Metaconfig API.
+It's usefulness seems extremely limited, but we will 
+reconsider adding it back in a furture version.
+
+Multi-package support has also been removed.
+
+--
+Website: http://setup.rubyforge.org
+

data/README

@@ -0,0 +1,110 @@
+= 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'.
+* The Metacofig API is not currently supported.
+* Multi-package project layouts are no longer supported.
+
+
+== Install
+
+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:
+
+  $ script/install
+
+
+
+== Usage
+
+Please see the documentation in doc/manual.
+
+To use setup.rb a project must conform to the setup.rb
+standard layout.
+
+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 .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 .installedfiles
+file!
+
+
+
+== To Do
+
+* Maybe protect .installedfiles from removal, even on distclean.
+* Separate compiling code into separate class.
+
+
+
+== License
+
+Copyright (c) 2002,2005 Minero Aoki
+Copyright (c) 2008 TigerOps & 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
+
+

data/bin/setup.rb

@@ -0,0 +1,7 @@
+#!/usr/bin/env ruby
+
+require 'setup/command'
+
+Setup::Command.run
+
+

data/doc/manual/doc.en/devel.html

@@ -0,0 +1,208 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+<html lang="en">
+<head>
+  <meta http-equiv="Content-Type" content="text/html; charset=us-ascii">
+  <meta http-equiv="Content-Language" content="en">
+<title>Creating Packages with setup.rb</title>
+</head>
+<body>
+
+<h1>Creating Packages with setup.rb</h1>
+<h2>Creating Single Package Archive</h2>
+<p>
+&quot;Single Package Archive&quot; means the archive which includes
+only one PACKAGE.  &quot;package&quot; means one set of ruby scripts,
+ruby extentions, commands, and data files.
+</p>
+<p>
+setup.rb requires that the archive is structured like this:
+</p>
+<pre>
+PackageTop/
+    setup.rb
+    lib/
+        (ruby scripts)
+    ext/
+        (ruby extentions)
+    bin/
+        (commands)
+    data/
+        (data files)
+    conf/
+        (configuration files)
+    man/
+        (manual pages)
+    test/
+        (tests)
+</pre>
+<p>
+Each file/directories acts as below:
+</p>
+<dl>
+<dt>setup.rb</dt>
+<dd><p>
+The installer. This file is included in this archive.
+Just copy it to your package.
+</p>
+</dd>
+<dt>lib/, bin/, data/, conf/, man/</dt>
+<dd><p>
+These directories includes files which are to be installed.
+This directory tree is mirrored to the target directory, from 'lib/'
+to 'RUBYLIB/', from 'bin/' to 'BINDIR/', from 'data/' to 'DATADIR/' ....
+</p>
+<p>
+Use 'lib/' for ruby scripts, 'bin/' for commands, 'data/' for any
+other data files, 'conf/' for configuration files, 'man/' for
+manual pages.
+</p>
+</dd>
+<dt>ext/</dt>
+<dd><p>
+'ext/' directory includes source code of ruby extentions.
+If you want to install 'RUBYLIB/ARCH/someext.so', create
+a directory 'ext/someext/' and put source files into it.
+</p>
+<p>
+[WARNING] All extention source directories MUST include
+extconf.rb or MANIFEST.
+</p>
+</dd>
+<dt>test/</dt>
+<dd><p>
+'test/' directory contains test scripts.  You must write
+test scripts which run on test/unit library.
+</p>
+</dd>
+</dl>
+<h2>Creating Multi-Package Archive</h2>
+<p>
+setup.rb can handle an archive which includes multiple PACKAGEs.
+</p>
+<p>
+setup.rb requires the archive is structured as below:
+</p>
+<pre>
+PackageTop/
+    setup.rb
+    packages/         &lt;--- fixed name
+        tmail/        &lt;--- tmail package
+            bin/
+            lib/
+            ext/
+            data/
+            conf/
+            man/
+            test/
+        raccrt/       &lt;--- raccrt package
+            bin/
+            lib/
+            ext/
+            data/
+            conf/
+            man/
+            test/
+        strscan/      &lt;--- strscan package
+            bin/
+            lib/
+            ext/
+            data/
+            conf/
+            man/
+            test/
+        amstd/        &lt;--- amstd package
+            bin/
+            lib/
+            ext/
+            data/
+            conf/
+            man/
+            test/
+</pre>
+<h2>Hooking Tasks</h2>
+<p>
+You can hook any tasks, such as &quot;config&quot; &quot;setup&quot;.
+For example, you want to make some files in 'lib/tmail/' when setup.
+Then create file 'lib/tmail/pre-setup.rb' and put this:
+</p>
+<pre>
+# pre-setup.rb
+
+# process grammer file
+system &quot;racc #{srcdir_root + '/src/mp.y'} -o mailp.rb&quot;
+
+# require all ruby scripts in this directory from _loadlib.rb.
+list = Dir.glob(curr_srcdir + '/*.rb').collect {|n| File.basename(n) }
+File.open( '_loadlib.rb', 'w' ) {|f|
+  f.puts list.collect {|n| &quot;require 'tmail/&quot; + n + &quot;'&quot; }
+}
+File.open( '../tmail.rb', 'w' ) {|f|
+  f.puts &quot;require 'tmail/_loadlib'&quot;
+}
+</pre>
+<p>
+This file is evaluated on task &quot;setup&quot; in the directory,
+before processing any other thing. Acceptable hook file names are:
+</p>
+<pre>
+{pre,post}-{config,setup,install,test,clean,distclean}.rb
+</pre>
+<p>
+[NOTE] You can also put hook files in the top directory of archive
+and/or the type-root directory ('bin/', 'lib/',...).
+</p>
+<h2>srcdir/objdir support</h2>
+<p>
+setup.rb supports srcdir/objdir separation. In other words,
+you can compile everything out of the source directory.
+</p>
+<p>
+If you write hooks, you should supports srcdir/objdir system.
+When you read source code, read it from srcdir. When you write
+anything, write it to the current directory. There's also some
+APIs to help your work. see
+,&lt;a href=&quot;hookapi.html&quot;&gt;Hook Script APIs Reference Manual&lt;/a&gt;
+</p>
+<h2>metaconfig</h2>
+<p>
+You can add new config options by writing file &quot;metaconfig&quot;.
+metaconfig must be placed in the package-root directory.
+</p>
+<p>
+Here is a simple example of metaconfig.
+</p>
+<pre>
+add_path_config 'libc', '/lib/libc.so', 'path to the C standard library'
+add_bool_config 'win32', false, 'compile with Win32 support'
+</pre>
+<p>
+This script defined new config option --libc and --win32.
+</p>
+<p>
+In 'metaconfig', you can use some APIs described in
+,&lt;a href=&quot;metaconfapi.html&quot;&gt;metaconfig API Reference Manual&lt;/a&gt;
+</p>
+<h2>Backward Compatibility</h2>
+<p>
+I do not assure any backward compatibility for the setup.rb.
+If you'd like old behavior, just use old version.
+</p>
+<h2>License</h2>
+<p>
+GNU LGPL, Lesser General Public License version 2.1.
+For details, see file &quot;COPYING&quot;.
+</p>
+<p>
+NOTE: You CAN distribute your program under the any licenses
+you like. LGPL does not force you to make your programs LGPL
+while the installer is LGPL'ed one.
+</p>
+<h2>Installation Manual</h2>
+<p>
+You can freely copy/edit and/or distribute Usage_*.txt files
+which are included in this archive.  I do not claim any rights
+on them.  Removing my copyright is also OK.
+</p>
+
+</body>
+</html>