reap 4.3.2 → 4.3.3
Sign up to get free protection for your applications and to get access to all the features.
- data/ANN +6 -1
- data/ProjectInfo +9 -7
- data/README +44 -13
- data/data/reap/setup-3.4.1/COPYING +515 -0
- data/data/reap/setup-3.4.1/ChangeLog +732 -0
- data/data/reap/setup-3.4.1/Makefile +56 -0
- data/data/reap/setup-3.4.1/NEWS.en +155 -0
- data/data/reap/setup-3.4.1/NEWS.ja +152 -0
- data/data/reap/setup-3.4.1/README.en +30 -0
- data/data/reap/setup-3.4.1/README.ja +34 -0
- data/data/reap/setup-3.4.1/TODO +14 -0
- data/data/reap/setup-3.4.1/Template.README.en +41 -0
- data/data/reap/setup-3.4.1/Template.README.ja +46 -0
- data/data/reap/setup-3.4.1/Usage_en.txt +231 -0
- data/data/reap/setup-3.4.1/Usage_ja.txt +250 -0
- data/data/reap/setup-3.4.1/doc.en/hookapi.html +91 -0
- data/data/reap/setup-3.4.1/doc.en/index.html +28 -0
- data/data/reap/setup-3.4.1/doc.en/metaconfapi.html +79 -0
- data/data/reap/setup-3.4.1/doc.en/news.html +189 -0
- data/data/reap/setup-3.4.1/doc.en/usage.html +297 -0
- data/data/reap/setup-3.4.1/doc.ja/hookapi.html +84 -0
- data/data/reap/setup-3.4.1/doc.ja/index.html +28 -0
- data/data/reap/setup-3.4.1/doc.ja/metaconfapi.html +80 -0
- data/data/reap/setup-3.4.1/doc.ja/news.html +186 -0
- data/data/reap/setup-3.4.1/doc.ja/usage.html +319 -0
- data/data/reap/setup-3.4.1/sample/add-task.rb +15 -0
- data/data/reap/setup-3.4.1/setup.rb +1585 -0
- data/data/reap/setup-3.4.1/test/test_installer.rb +136 -0
- data/lib/reap/{lint.rb → bin/lint.rb} +0 -0
- data/lib/reap/bin/reap.rb +3 -2
- data/lib/reap/projectinfo.rb +4 -0
- data/lib/reap/task.rb +84 -74
- data/lib/reap/task/announce.rb +137 -91
- data/lib/reap/task/fileperm.rb +26 -9
- data/lib/reap/task/info.rb +19 -3
- data/lib/reap/task/install.rb +9 -7
- data/lib/reap/task/noop.rb +3 -5
- data/lib/reap/task/package.rb +247 -105
- data/lib/reap/task/publish.rb +40 -14
- data/lib/reap/task/rdoc.rb +53 -27
- data/lib/reap/task/release.rb +275 -73
- data/lib/reap/task/scaffold.rb +14 -6
- data/lib/reap/task/test.rb +67 -48
- data/lib/reap/task/testext.rb +38 -11
- data/lib/reap/vendor/http-access2.rb +1590 -0
- data/lib/reap/vendor/http-access2/cookie.rb +538 -0
- data/lib/reap/vendor/http-access2/http.rb +542 -0
- data/{lib/reap → note}/interface/interface.rb +0 -0
- data/{lib/reap → note}/interface/rubyforge.rb +0 -0
- data/note/package.rb.0 +394 -0
- metadata +43 -8
- data/lib/reap/reap.rb +0 -0
@@ -0,0 +1,91 @@
|
|
1
|
+
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
2
|
+
<html lang="en">
|
3
|
+
<head>
|
4
|
+
<meta http-equiv="Content-Type" content="text/html; charset=us-ascii">
|
5
|
+
<meta http-equiv="Content-Language" content="en">
|
6
|
+
<title>Hook Script API</title>
|
7
|
+
</head>
|
8
|
+
<body>
|
9
|
+
|
10
|
+
<h1>Hook Script API</h1>
|
11
|
+
<dl>
|
12
|
+
<dt>get_config(<var>key</var>) -> String</dt>
|
13
|
+
<dt>config(<var>key</var>) -> String</dt>
|
14
|
+
<dd><p>
|
15
|
+
get a configuration. (e.g. config('prefix') for --prefix)
|
16
|
+
</p>
|
17
|
+
</dd>
|
18
|
+
<dt>set_config(<var>key</var>, <var>val</var>)</dt>
|
19
|
+
<dd><p>
|
20
|
+
set a configuration KEY to VAL. (e.g. set_config("prefix", "/usr"))
|
21
|
+
</p>
|
22
|
+
</dd>
|
23
|
+
<dt>curr_srcdir -> String</dt>
|
24
|
+
<dd><p>
|
25
|
+
the current srcdir.
|
26
|
+
</p>
|
27
|
+
</dd>
|
28
|
+
<dt>curr_objdir -> String</dt>
|
29
|
+
<dd><p>
|
30
|
+
the current objdir.
|
31
|
+
</p>
|
32
|
+
</dd>
|
33
|
+
<dt>srcdir_root -> String</dt>
|
34
|
+
<dd><p>
|
35
|
+
the root directory of srcdir.
|
36
|
+
When the hook script is called from setup.rb, this method
|
37
|
+
returns the top directory of each package directory
|
38
|
+
(ARCHIVE_TOP/packages/*/).
|
39
|
+
</p>
|
40
|
+
</dd>
|
41
|
+
<dt>objdir_root -> String</dt>
|
42
|
+
<dd><p>
|
43
|
+
the root directory of objdir.
|
44
|
+
When the hook script is called from setup.rb, this method
|
45
|
+
returns the top directory of each package directory
|
46
|
+
(OBJDIR/packages/*/).
|
47
|
+
</p>
|
48
|
+
</dd>
|
49
|
+
<dt>srcfile(<var>filename</var>) -> String</dt>
|
50
|
+
<dd><p>
|
51
|
+
expands relational path FNAME which is in the current srcdir,
|
52
|
+
into the absolute path.
|
53
|
+
</p>
|
54
|
+
</dd>
|
55
|
+
<dt>srcexist?(<var>filename</var>)</dt>
|
56
|
+
<dd><p>
|
57
|
+
true if a file FNAME exists in the current srcdir.
|
58
|
+
</p>
|
59
|
+
</dd>
|
60
|
+
<dt>srcdirectory?(<var>filename</var>)</dt>
|
61
|
+
<dd><p>
|
62
|
+
true if a directory FNAME exists in the current srcdir.
|
63
|
+
</p>
|
64
|
+
</dd>
|
65
|
+
<dt>srcfile?(<var>filename</var>)</dt>
|
66
|
+
<dd><p>
|
67
|
+
true if a normal file FNAME exists in the current srcdir.
|
68
|
+
</p>
|
69
|
+
</dd>
|
70
|
+
<dt>srcentries(<var>relative_path</var> = '.') -> [String]</dt>
|
71
|
+
<dd><p>
|
72
|
+
returns the list of file entiries in the directory
|
73
|
+
"current srcdir + '/' + relpath"
|
74
|
+
</p>
|
75
|
+
</dd>
|
76
|
+
<dt>srcfiles(<var>relative_path</var> = '.') -> [String]</dt>
|
77
|
+
<dd><p>
|
78
|
+
returns the list of file names in the directory
|
79
|
+
"current srcdir + '/' + relpath"
|
80
|
+
</p>
|
81
|
+
</dd>
|
82
|
+
<dt>srcdirectories(<var>relative_path</var> = '.') -> [String]</dt>
|
83
|
+
<dd><p>
|
84
|
+
returns the list of directory names in the directory
|
85
|
+
"current srcdir + '/' + relpath"
|
86
|
+
</p>
|
87
|
+
</dd>
|
88
|
+
</dl>
|
89
|
+
|
90
|
+
</body>
|
91
|
+
</html>
|
@@ -0,0 +1,28 @@
|
|
1
|
+
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
2
|
+
<html lang="en">
|
3
|
+
<head>
|
4
|
+
<meta http-equiv="Content-Type" content="text/html; charset=us-ascii">
|
5
|
+
<meta http-equiv="Content-Language" content="en">
|
6
|
+
<title>setup.rb User Manual</title>
|
7
|
+
</head>
|
8
|
+
<body>
|
9
|
+
|
10
|
+
<h1>setup.rb User Manual</h1>
|
11
|
+
<p>
|
12
|
+
setup.rb is the generic installer for ruby scripts/extentions.
|
13
|
+
You can automate configuration and installation of your program
|
14
|
+
package.
|
15
|
+
</p>
|
16
|
+
|
17
|
+
<ul>
|
18
|
+
<li><a href="usage.html">Installing Packages with setup.rb</a>
|
19
|
+
<li><a href="devel.html">Creating Packages Using setup.rb</a>
|
20
|
+
<li><a href="hookapi.html">Hook Script APIs Reference Manual</a>
|
21
|
+
<li><a href="metaconfapi.html">metaconfig APIs Reference Manual</a>
|
22
|
+
|
23
|
+
<li><a href="news.html">NEWS</a>
|
24
|
+
|
25
|
+
</ul>
|
26
|
+
|
27
|
+
</body>
|
28
|
+
</html>
|
@@ -0,0 +1,79 @@
|
|
1
|
+
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
2
|
+
<html lang="en">
|
3
|
+
<head>
|
4
|
+
<meta http-equiv="Content-Type" content="text/html; charset=us-ascii">
|
5
|
+
<meta http-equiv="Content-Language" content="en">
|
6
|
+
<title>metaconfig API</title>
|
7
|
+
</head>
|
8
|
+
<body>
|
9
|
+
|
10
|
+
<h1>metaconfig API</h1>
|
11
|
+
<dl>
|
12
|
+
<dt>add_path_config(<var>confname</var>, <var>default</var>, <var>description</var>)</dt>
|
13
|
+
<dd><dl class="typedecl">
|
14
|
+
<dt>confname</dt><dd>String</dd>
|
15
|
+
<dt>default</dt><dd>String</dd>
|
16
|
+
<dt>description</dt><dd>String</dd>
|
17
|
+
</dl>
|
18
|
+
<p>
|
19
|
+
defines a path config option CONFNAME.
|
20
|
+
DEFAULT is the <var>default</var> value of this option.
|
21
|
+
DESCRIPTION is the short <var>description</var> of this option
|
22
|
+
which is used from '--help' global option.
|
23
|
+
</p>
|
24
|
+
</dd>
|
25
|
+
<dt>add_bool_config(<var>confname</var>, <var>default</var>, <var>description</var>)</dt>
|
26
|
+
<dd><dl class="typedecl">
|
27
|
+
<dt>confname</dt><dd>String</dd>
|
28
|
+
<dt>default</dt><dd>String</dd>
|
29
|
+
<dt>description</dt><dd>String</dd>
|
30
|
+
</dl>
|
31
|
+
<p>
|
32
|
+
defines a bool config option CONFNAME.
|
33
|
+
DEFAULT is the <var>default</var> value of this option.
|
34
|
+
DESCRIPTION is the short <var>description</var> of this option
|
35
|
+
which is used from '--help' global option.
|
36
|
+
</p>
|
37
|
+
</dd>
|
38
|
+
<dt>set_config_default(<var>confname</var>, <var>val</var>)</dt>
|
39
|
+
<dd><dl class="typedecl">
|
40
|
+
<dt>confname</dt><dd>String</dd>
|
41
|
+
<dt>val</dt><dd>String | bool</dd>
|
42
|
+
</dl>
|
43
|
+
<p>
|
44
|
+
set <var>default</var> value of config CONFNAME to VAL.
|
45
|
+
If CONFNAME is a bool config, VAL should be boolean.
|
46
|
+
Else VAL should be a String.
|
47
|
+
</p>
|
48
|
+
</dd>
|
49
|
+
<dt>remove_config(<var>confname</var>)</dt>
|
50
|
+
<dd><dl class="typedecl">
|
51
|
+
<dt>confname</dt><dd>String</dd>
|
52
|
+
</dl>
|
53
|
+
<p>
|
54
|
+
removes config entry CONFNAME from the installer completely.
|
55
|
+
You must use this method at your own lisk. For example,
|
56
|
+
'remove_config("prefix")' causes fatal error.
|
57
|
+
</p>
|
58
|
+
</dd>
|
59
|
+
<dt>packages -> [String]</dt>
|
60
|
+
<dd><p>
|
61
|
+
Returns the list of package names.
|
62
|
+
This method raises RuntimeError if called in the single
|
63
|
+
package archive.
|
64
|
+
</p>
|
65
|
+
</dd>
|
66
|
+
<dt>declare_packages(<var>list</var>)</dt>
|
67
|
+
<dd><dl class="typedecl">
|
68
|
+
<dt>list</dt><dd>[String]</dd>
|
69
|
+
</dl>
|
70
|
+
<p>
|
71
|
+
Set the ordered <var>list</var> of installing package names.
|
72
|
+
This method raises RuntimeError if called in the single
|
73
|
+
package archive.
|
74
|
+
</p>
|
75
|
+
</dd>
|
76
|
+
</dl>
|
77
|
+
|
78
|
+
</body>
|
79
|
+
</html>
|
@@ -0,0 +1,189 @@
|
|
1
|
+
<h1>NEWS</h1>
|
2
|
+
<h2>3.4.1 (2005-11-20)</h2>
|
3
|
+
<ul>
|
4
|
+
<li>[CHANGE] do not apply *.rb filter for lib/**.</li>
|
5
|
+
<li>[CHANGE] updates "#!/usr/bin/env ruby" on --shebang=ruby (it is default).</li>
|
6
|
+
<li>[fix] --shebang option did not work.</li>
|
7
|
+
<li>[fix] --without-ext option did not work.</li>
|
8
|
+
<li>[fix] default --rubypath value should include file extension. (Thanks U.Nakamura)</li>
|
9
|
+
<li>[fix] task SHOW, SETUP, TEST, CLEAN, DISTCLEAN with any argument wrongly caused exception.</li>
|
10
|
+
</ul>
|
11
|
+
<h2>3.4.0 (2005-09-25)</h2>
|
12
|
+
<ul>
|
13
|
+
<li>[fix] fix Windows specific bug, which causes error while
|
14
|
+
modifying bin/*.rb files in setup phase.</li>
|
15
|
+
<li>[new] new task `test'.</li>
|
16
|
+
<li>[new] installs configuration files from conf/.</li>
|
17
|
+
<li>[new] installs man pages from man/.</li>
|
18
|
+
<li>[new] new config option: --installdirs.</li>
|
19
|
+
<li>[new] new config option: --shebang.</li>
|
20
|
+
<li>[new] new config option: --sysconfdir.</li>
|
21
|
+
<li>[new] new config option: --mandir.</li>
|
22
|
+
<li>[new] new config option: --libruby.</li>
|
23
|
+
<li>[new] new config option: --localstetedir.</li>
|
24
|
+
</ul>
|
25
|
+
<h2>3.3.1 (2004-10-02)</h2>
|
26
|
+
<ul>
|
27
|
+
<li>[fix] `install' did not work if bin/*.rb exists.</li>
|
28
|
+
<li>[fix] relative $prefix path caused infinite loop.</li>
|
29
|
+
</ul>
|
30
|
+
<h2>3.3.0 (2004-09-21)</h2>
|
31
|
+
<ul>
|
32
|
+
<li>[new] Invoke config-setup-install when no global task is given.</li>
|
33
|
+
<li>[new] new task `all', which invokes config-setup-install.</li>
|
34
|
+
</ul>
|
35
|
+
<h2>3.2.4 (2004-02-12)</h2>
|
36
|
+
<ul>
|
37
|
+
<li>[new] get default value of --make-prog from CONFIG['configure_args']. [ruby-list:39186]</li>
|
38
|
+
<li>[fix] open files in binary mode, also on ruby 1.8. [ruby-list:39184]</li>
|
39
|
+
<li>[fix] wrong path was written in InstalledFiles.</li>
|
40
|
+
</ul>
|
41
|
+
<h2>3.2.3 (2004-02-12)</h2>
|
42
|
+
<ul>
|
43
|
+
<li>[fix] open files in binary mode. [ruby-list:39158]</li>
|
44
|
+
</ul>
|
45
|
+
<h2>3.2.2 (2003-12-16)</h2>
|
46
|
+
<ul>
|
47
|
+
<li>[fix] did not work with metaconfig. (thanks Guillaume Marcais)</li>
|
48
|
+
<li>[fix] should save configurations after running all hooks. (thanks Alex Fenton)</li>
|
49
|
+
<li>[fix] does not reject *.elc, *.so, etc. (thanks Rubikitch)</li>
|
50
|
+
</ul>
|
51
|
+
<h2>3.2.1 (2003-09-01)</h2>
|
52
|
+
<ul>
|
53
|
+
<li>[fix] did not work.</li>
|
54
|
+
</ul>
|
55
|
+
<h2>3.2.0 (2003-08-27)</h2>
|
56
|
+
<ul>
|
57
|
+
<li>[CHANGE] install.rb is merged into the setup.rb.</li>
|
58
|
+
<li>[fix] clean/distclean should be able to invoke before configuring.</li>
|
59
|
+
</ul>
|
60
|
+
<h2>3.1.5 (2003-08-21)</h2>
|
61
|
+
<ul>
|
62
|
+
<li>[CHANGE] install only *.rb from the lib/ directory.</li>
|
63
|
+
<li>[CHANGE] ban MANIFEST.</li>
|
64
|
+
</ul>
|
65
|
+
<h2>3.1.4 (2003-02-25)</h2>
|
66
|
+
<ul>
|
67
|
+
<li>[new] ignore CVS/ *~ *.bak #* .* etc.</li>
|
68
|
+
<li>[new] explicit file designation by MANIFEST.</li>
|
69
|
+
<li>[new] new task `distclean'.</li>
|
70
|
+
<li>bundle Makefile and asm.rb, which are tools to create
|
71
|
+
install.rb/setup.rb from source file.</li>
|
72
|
+
</ul>
|
73
|
+
<h2>3.1.3 (2002-12-06)</h2>
|
74
|
+
<ul>
|
75
|
+
<li>better help message.</li>
|
76
|
+
</ul>
|
77
|
+
<h2>3.1.2 (2002-05-07)</h2>
|
78
|
+
<ul>
|
79
|
+
<li>[fix] config --without did not work.</li>
|
80
|
+
<li>[fix] wrong filenames were written to InstalledFiles.</li>
|
81
|
+
</ul>
|
82
|
+
<h2>3.1.1 (2002-01-11)</h2>
|
83
|
+
<ul>
|
84
|
+
<li>[CHANGE] changes "config --install-prefix" to "install --prefix"</li>
|
85
|
+
<li>[new] new config option --site-ruby-common</li>
|
86
|
+
<li>[new] new metaconfig interface set_config_default(n,v)</li>
|
87
|
+
</ul>
|
88
|
+
<h2>3.1.0 (2002-01-08)</h2>
|
89
|
+
<ul>
|
90
|
+
<li>[new] new config option --without-ext</li>
|
91
|
+
<li>[new] new config option --install-prefix</li>
|
92
|
+
<li>[new] new hook interface get_config(k), set_config(k,v)</li>
|
93
|
+
<li>[new] config option config file 'metaconfig'</li>
|
94
|
+
<li>[fix] setup.rb executes hooks in top directory
|
95
|
+
(does not run hooks in packages/ dir. This is a feature.)</li>
|
96
|
+
</ul>
|
97
|
+
<h2>3.0.2 (2001-10-01)</h2>
|
98
|
+
<ul>
|
99
|
+
<li>did not work on Ruby 1.4.4 ... 1.6.3
|
100
|
+
(rbconfig['rubylidir'] does not exist.)</li>
|
101
|
+
</ul>
|
102
|
+
<h2>3.0.1 (2001-09-07)</h2>
|
103
|
+
<ul>
|
104
|
+
<li>new options -q, --quiet, --verbose</li>
|
105
|
+
<li>parametarizes 'setup.rb' in strings</li>
|
106
|
+
</ul>
|
107
|
+
<h2>3.0.0 (2001-08-28)</h2>
|
108
|
+
<ul>
|
109
|
+
<li>archive structure completely changed.</li>
|
110
|
+
<li>single package installer install.rb</li>
|
111
|
+
<li>restructs setup.rb</li>
|
112
|
+
<li>outputs installed file names into the file "InstalledFiles"</li>
|
113
|
+
<li>--with/--without accepts only package names.</li>
|
114
|
+
<li>"config -- --with-foo=bar" passes options to extconf.rb</li>
|
115
|
+
<li>supports customized site_ruby (thanks Akira Yamada)</li>
|
116
|
+
</ul>
|
117
|
+
<h2>2.2.1 (2001-08-01)</h2>
|
118
|
+
<ul>
|
119
|
+
<li>modify --with and --without (reported by Knu)</li>
|
120
|
+
</ul>
|
121
|
+
<h2>2.2.0 (2001-06-30)</h2>
|
122
|
+
<ul>
|
123
|
+
<li>ban PATHCONV. Use setup/*.rb instead.</li>
|
124
|
+
</ul>
|
125
|
+
<h2>2.1.0 (2001-06-30)</h2>
|
126
|
+
<ul>
|
127
|
+
<li>support parameterized config value (i.e. --prefix)</li>
|
128
|
+
<li>Developpers can hook any tasks. (thanks rubikitch)</li>
|
129
|
+
<li>support srcdir</li>
|
130
|
+
</ul>
|
131
|
+
<h2>2.0.4 (2001-04-07)</h2>
|
132
|
+
<ul>
|
133
|
+
<li>support Ruby 1.4</li>
|
134
|
+
</ul>
|
135
|
+
<h2>2.0.3 (2001-03-26)</h2>
|
136
|
+
<ul>
|
137
|
+
<li>ignore if Makefile is not exist when "make clean"</li>
|
138
|
+
<li>avoids windows' stat() bug</li>
|
139
|
+
</ul>
|
140
|
+
<h2>2.0.2 (2001-02-13)</h2>
|
141
|
+
<ul>
|
142
|
+
<li>ignore if Makefile is not exist when "make clean" (thanks rubikitch)</li>
|
143
|
+
<li>support DOS's drive letter</li>
|
144
|
+
</ul>
|
145
|
+
<h2>2.0.1 (2001-02-09)</h2>
|
146
|
+
<ul>
|
147
|
+
<li>does "make clean" on each SETUP</li>
|
148
|
+
<li>does not fork new ruby process when executing extconf.rb</li>
|
149
|
+
<li>config --rbconfig=file</li>
|
150
|
+
</ul>
|
151
|
+
<h2>2.0.0 (2000-12-19)</h2>
|
152
|
+
<ul>
|
153
|
+
<li>now setup.rb does not depend on amstd</li>
|
154
|
+
<li>install --no-harm</li>
|
155
|
+
<li>add templates</li>
|
156
|
+
</ul>
|
157
|
+
<h2>1.0.7 (2000-11-18)</h2>
|
158
|
+
<ul>
|
159
|
+
<li>allow --without=ext/*</li>
|
160
|
+
</ul>
|
161
|
+
<h2>1.0.6 (2000-08-27)</h2>
|
162
|
+
<ul>
|
163
|
+
<li>new option --make-prog=[make] (patched by Katsuyuki Komatsu)</li>
|
164
|
+
</ul>
|
165
|
+
<h2>1.0.5 (2000-08-27)</h2>
|
166
|
+
<ul>
|
167
|
+
<li>generates Makefile every time</li>
|
168
|
+
</ul>
|
169
|
+
<h2>1.0.4 (2000-07-13)</h2>
|
170
|
+
<ul>
|
171
|
+
<li>can pass directory name (like ext/cparse) for --with, --without</li>
|
172
|
+
</ul>
|
173
|
+
<h2>1.0.3 (2000-06-08)</h2>
|
174
|
+
<ul>
|
175
|
+
<li>new command dryrun (patched by rubikitch)</li>
|
176
|
+
</ul>
|
177
|
+
<h2>1.0.2 (2000-06-03)</h2>
|
178
|
+
<ul>
|
179
|
+
<li>update document</li>
|
180
|
+
</ul>
|
181
|
+
<h2>1.0.1 (2000-06-01)</h2>
|
182
|
+
<ul>
|
183
|
+
<li>modify syntax error (patched by rubikitch)</li>
|
184
|
+
<li>new command "clean" (patched by rubikitch)</li>
|
185
|
+
</ul>
|
186
|
+
<h2>1.0.0 (2000-05-30)</h2>
|
187
|
+
<ul>
|
188
|
+
<li>first release</li>
|
189
|
+
</ul>
|
@@ -0,0 +1,297 @@
|
|
1
|
+
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
2
|
+
<html lang="en">
|
3
|
+
<head>
|
4
|
+
<meta http-equiv="Content-Type" content="text/html; charset=us-ascii">
|
5
|
+
<meta http-equiv="Content-Language" content="en">
|
6
|
+
<title>Installing Programs with setup.rb</title>
|
7
|
+
</head>
|
8
|
+
<body>
|
9
|
+
|
10
|
+
<h1>Installing Programs with setup.rb</h1>
|
11
|
+
<h2>Quick Start</h2>
|
12
|
+
<p>
|
13
|
+
Type this (You might needs super user previledge):
|
14
|
+
</p>
|
15
|
+
<pre>
|
16
|
+
($ su)
|
17
|
+
# ruby setup.rb
|
18
|
+
</pre>
|
19
|
+
<p>
|
20
|
+
If you want to install a program in to your home directory
|
21
|
+
($HOME), use following instead:
|
22
|
+
</p>
|
23
|
+
<pre>
|
24
|
+
$ ruby setup.rb all --prefix=$HOME
|
25
|
+
</pre>
|
26
|
+
<h2>Detailed Installtion Process</h2>
|
27
|
+
<p>
|
28
|
+
setup.rb invokes installation by three steps. There are
|
29
|
+
"config", "setup" and "install". You can invoke each steps
|
30
|
+
separately as following:
|
31
|
+
</p>
|
32
|
+
<pre>
|
33
|
+
$ ruby setup.rb config
|
34
|
+
$ ruby setup.rb setup
|
35
|
+
# ruby setup.rb install
|
36
|
+
</pre>
|
37
|
+
<p>
|
38
|
+
You can controll installation process by giving detailed
|
39
|
+
options for each tasks. For example, --bin-dir=$HOME/bin
|
40
|
+
let setup.rb install commands in $HOME/bin.
|
41
|
+
</p>
|
42
|
+
<p>
|
43
|
+
For details, see "Task Options".
|
44
|
+
</p>
|
45
|
+
<h2>Global Options</h2>
|
46
|
+
<p>
|
47
|
+
"Global Option" is a command line option which you can use
|
48
|
+
for all tasks. You must give a global option before any task
|
49
|
+
name.
|
50
|
+
</p>
|
51
|
+
<dl>
|
52
|
+
<dt>-q,--quiet</dt>
|
53
|
+
<dd><p>
|
54
|
+
suppress message outputs
|
55
|
+
</p>
|
56
|
+
</dd>
|
57
|
+
<dt>--verbose</dt>
|
58
|
+
<dd><p>
|
59
|
+
output messages verbosely (default)
|
60
|
+
</p>
|
61
|
+
</dd>
|
62
|
+
<dt>-h,--help</dt>
|
63
|
+
<dd><p>
|
64
|
+
prints help and quit
|
65
|
+
</p>
|
66
|
+
</dd>
|
67
|
+
<dt>-v,--version</dt>
|
68
|
+
<dd><p>
|
69
|
+
prints version and quit
|
70
|
+
</p>
|
71
|
+
</dd>
|
72
|
+
<dt>--copyright</dt>
|
73
|
+
<dd><p>
|
74
|
+
prints copyright and quit
|
75
|
+
</p>
|
76
|
+
</dd>
|
77
|
+
</dl>
|
78
|
+
<h2>Tasks</h2>
|
79
|
+
<p>
|
80
|
+
These are acceptable tasks:
|
81
|
+
</p>
|
82
|
+
<dl>
|
83
|
+
<dt>all</dt>
|
84
|
+
<dd><p>
|
85
|
+
Invokes `config', `setup', then `install'.
|
86
|
+
Task options for all is same with config.
|
87
|
+
</p>
|
88
|
+
</dd>
|
89
|
+
<dt>config</dt>
|
90
|
+
<dd><p>
|
91
|
+
Checks and saves configurations.
|
92
|
+
</p>
|
93
|
+
</dd>
|
94
|
+
<dt>show</dt>
|
95
|
+
<dd><p>
|
96
|
+
Prints current configurations.
|
97
|
+
</p>
|
98
|
+
</dd>
|
99
|
+
<dt>setup</dt>
|
100
|
+
<dd><p>
|
101
|
+
Compiles ruby extentions.
|
102
|
+
</p>
|
103
|
+
</dd>
|
104
|
+
<dt>install</dt>
|
105
|
+
<dd><p>
|
106
|
+
Installs files.
|
107
|
+
</p>
|
108
|
+
</dd>
|
109
|
+
<dt>test</dt>
|
110
|
+
<dd><p>
|
111
|
+
Invokes tests.
|
112
|
+
</p>
|
113
|
+
</dd>
|
114
|
+
<dt>clean</dt>
|
115
|
+
<dd><p>
|
116
|
+
Removes created files.
|
117
|
+
</p>
|
118
|
+
</dd>
|
119
|
+
<dt>distclean</dt>
|
120
|
+
<dd><p>
|
121
|
+
Removes all created files.
|
122
|
+
</p>
|
123
|
+
</dd>
|
124
|
+
</dl>
|
125
|
+
<h2>Task Options for CONFIG/ALL</h2>
|
126
|
+
<p>
|
127
|
+
You can pass following long options for CONFIG task
|
128
|
+
and ALL task.
|
129
|
+
</p>
|
130
|
+
<p>
|
131
|
+
All options accept parameterized value, like
|
132
|
+
--rbdir=$siterubyver or --sodir=$siterubyverarch.
|
133
|
+
On UNIX shells, you should escape "$" character,
|
134
|
+
so use --rbdir=\$siterubyver or --sodir=$siterubyverach.
|
135
|
+
</p>
|
136
|
+
<dl>
|
137
|
+
<dt>--installdirs=(std|site|home)</dt>
|
138
|
+
<dd><p>
|
139
|
+
A handy option to set common install target.
|
140
|
+
</p>
|
141
|
+
<p>
|
142
|
+
std: install files under $libruby.
|
143
|
+
</p>
|
144
|
+
<p>
|
145
|
+
site: install files under $siteruby.
|
146
|
+
</p>
|
147
|
+
<p>
|
148
|
+
home: install files under home directory ($HOME).
|
149
|
+
</p>
|
150
|
+
</dd>
|
151
|
+
<dt>--prefix=PATH</dt>
|
152
|
+
<dd><p>
|
153
|
+
The path prefix of target directory pathes like $bindir, $libdir...
|
154
|
+
</p>
|
155
|
+
</dd>
|
156
|
+
<dt>--bindir=PATH</dt>
|
157
|
+
<dd><p>
|
158
|
+
The directory for commands.
|
159
|
+
</p>
|
160
|
+
</dd>
|
161
|
+
<dt>--rbdir=PATH</dt>
|
162
|
+
<dd><p>
|
163
|
+
The directory for ruby scripts.
|
164
|
+
</p>
|
165
|
+
</dd>
|
166
|
+
<dt>--sodir=PATH</dt>
|
167
|
+
<dd><p>
|
168
|
+
The directory for ruby extentions.
|
169
|
+
</p>
|
170
|
+
</dd>
|
171
|
+
<dt>--datadir=PATH</dt>
|
172
|
+
<dd><p>
|
173
|
+
The directory for shared data.
|
174
|
+
</p>
|
175
|
+
</dd>
|
176
|
+
<dt>--sysconfdir=PATH</dt>
|
177
|
+
<dd><p>
|
178
|
+
The directory for configuration files.
|
179
|
+
</p>
|
180
|
+
</dd>
|
181
|
+
<dt>--mandir=PATH</dt>
|
182
|
+
<dd><p>
|
183
|
+
The directory for manual pages.
|
184
|
+
</p>
|
185
|
+
</dd>
|
186
|
+
<dt>--libruby=PATH</dt>
|
187
|
+
<dd><p>
|
188
|
+
The directory for ruby libraries.
|
189
|
+
</p>
|
190
|
+
</dd>
|
191
|
+
<dt>--librubyver=PATH</dt>
|
192
|
+
<dd><p>
|
193
|
+
The directory for standard ruby libraries.
|
194
|
+
</p>
|
195
|
+
</dd>
|
196
|
+
<dt>--librubyverarch=PATH</dt>
|
197
|
+
<dd><p>
|
198
|
+
The directory for standard ruby extensions.
|
199
|
+
</p>
|
200
|
+
</dd>
|
201
|
+
<dt>--siteruby=PATH</dt>
|
202
|
+
<dd><p>
|
203
|
+
The directory for version-independent non-standard
|
204
|
+
ruby libraries
|
205
|
+
</p>
|
206
|
+
</dd>
|
207
|
+
<dt>--siterubyver=PATH</dt>
|
208
|
+
<dd><p>
|
209
|
+
The directory for non-standard ruby libraries.
|
210
|
+
</p>
|
211
|
+
</dd>
|
212
|
+
<dt>--siterubyverarch=PATH</dt>
|
213
|
+
<dd><p>
|
214
|
+
The directory for non-standard ruby extensions.
|
215
|
+
</p>
|
216
|
+
</dd>
|
217
|
+
<dt>--rubypath=PATH</dt>
|
218
|
+
<dd><p>
|
219
|
+
The path to set to #! line.
|
220
|
+
</p>
|
221
|
+
</dd>
|
222
|
+
<dt>--shebang=(all|ruby|never)</dt>
|
223
|
+
<dd><p>
|
224
|
+
Shenbang line (#!) rewriting mode.
|
225
|
+
</p>
|
226
|
+
<p>
|
227
|
+
all: replace all shebang lines.
|
228
|
+
</p>
|
229
|
+
<p>
|
230
|
+
ruby: replace shebang lines which invokes ruby.
|
231
|
+
</p>
|
232
|
+
<p>
|
233
|
+
never: never rewrite shebang.
|
234
|
+
</p>
|
235
|
+
</dd>
|
236
|
+
<dt>--rubyprog=PATH</dt>
|
237
|
+
<dd><p>
|
238
|
+
The ruby program using for installation.
|
239
|
+
</p>
|
240
|
+
</dd>
|
241
|
+
<dt>--makeprog=NAME</dt>
|
242
|
+
<dd><p>
|
243
|
+
The make program to compile ruby extentions.
|
244
|
+
</p>
|
245
|
+
</dd>
|
246
|
+
<dt>--without-ext</dt>
|
247
|
+
<dd><p>
|
248
|
+
Forces to setup.rb never to compile/install
|
249
|
+
ruby extentions.
|
250
|
+
</p>
|
251
|
+
</dd>
|
252
|
+
<dt>--rbconfig=PATH</dt>
|
253
|
+
<dd><p>
|
254
|
+
Your rbconfig.rb to load.
|
255
|
+
</p>
|
256
|
+
</dd>
|
257
|
+
</dl>
|
258
|
+
<p>
|
259
|
+
If there's the directory named "packages",
|
260
|
+
You can also use these options:
|
261
|
+
</p>
|
262
|
+
<dl>
|
263
|
+
<dt>--with=NAME,NAME,NAME...</dt>
|
264
|
+
<dd><p>
|
265
|
+
Package names which you want to install.
|
266
|
+
</p>
|
267
|
+
</dd>
|
268
|
+
<dt>--without=NAME,NAME,NAME...</dt>
|
269
|
+
<dd><p>
|
270
|
+
Package names which you do not want to install.
|
271
|
+
</p>
|
272
|
+
</dd>
|
273
|
+
</dl>
|
274
|
+
<p>
|
275
|
+
[NOTE] You can pass options to extconf.rb like this:
|
276
|
+
</p>
|
277
|
+
<pre>
|
278
|
+
ruby setup.rb config -- --with-tklib=/usr/lib/libtk-ja.so.8.0
|
279
|
+
</pre>
|
280
|
+
<h2>Task Options for INSTALL</h2>
|
281
|
+
<dl>
|
282
|
+
<dt>--no-harm</dt>
|
283
|
+
<dd><p>
|
284
|
+
prints what to do and done nothing really.
|
285
|
+
</p>
|
286
|
+
</dd>
|
287
|
+
<dt>--prefix=PATH</dt>
|
288
|
+
<dd><p>
|
289
|
+
The prefix of the installing directory path.
|
290
|
+
This option may help binary package maintainers.
|
291
|
+
A default value is an empty string.
|
292
|
+
</p>
|
293
|
+
</dd>
|
294
|
+
</dl>
|
295
|
+
|
296
|
+
</body>
|
297
|
+
</html>
|