reap 4.3.2 → 4.3.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (52) hide show
  1. data/ANN +6 -1
  2. data/ProjectInfo +9 -7
  3. data/README +44 -13
  4. data/data/reap/setup-3.4.1/COPYING +515 -0
  5. data/data/reap/setup-3.4.1/ChangeLog +732 -0
  6. data/data/reap/setup-3.4.1/Makefile +56 -0
  7. data/data/reap/setup-3.4.1/NEWS.en +155 -0
  8. data/data/reap/setup-3.4.1/NEWS.ja +152 -0
  9. data/data/reap/setup-3.4.1/README.en +30 -0
  10. data/data/reap/setup-3.4.1/README.ja +34 -0
  11. data/data/reap/setup-3.4.1/TODO +14 -0
  12. data/data/reap/setup-3.4.1/Template.README.en +41 -0
  13. data/data/reap/setup-3.4.1/Template.README.ja +46 -0
  14. data/data/reap/setup-3.4.1/Usage_en.txt +231 -0
  15. data/data/reap/setup-3.4.1/Usage_ja.txt +250 -0
  16. data/data/reap/setup-3.4.1/doc.en/hookapi.html +91 -0
  17. data/data/reap/setup-3.4.1/doc.en/index.html +28 -0
  18. data/data/reap/setup-3.4.1/doc.en/metaconfapi.html +79 -0
  19. data/data/reap/setup-3.4.1/doc.en/news.html +189 -0
  20. data/data/reap/setup-3.4.1/doc.en/usage.html +297 -0
  21. data/data/reap/setup-3.4.1/doc.ja/hookapi.html +84 -0
  22. data/data/reap/setup-3.4.1/doc.ja/index.html +28 -0
  23. data/data/reap/setup-3.4.1/doc.ja/metaconfapi.html +80 -0
  24. data/data/reap/setup-3.4.1/doc.ja/news.html +186 -0
  25. data/data/reap/setup-3.4.1/doc.ja/usage.html +319 -0
  26. data/data/reap/setup-3.4.1/sample/add-task.rb +15 -0
  27. data/data/reap/setup-3.4.1/setup.rb +1585 -0
  28. data/data/reap/setup-3.4.1/test/test_installer.rb +136 -0
  29. data/lib/reap/{lint.rb → bin/lint.rb} +0 -0
  30. data/lib/reap/bin/reap.rb +3 -2
  31. data/lib/reap/projectinfo.rb +4 -0
  32. data/lib/reap/task.rb +84 -74
  33. data/lib/reap/task/announce.rb +137 -91
  34. data/lib/reap/task/fileperm.rb +26 -9
  35. data/lib/reap/task/info.rb +19 -3
  36. data/lib/reap/task/install.rb +9 -7
  37. data/lib/reap/task/noop.rb +3 -5
  38. data/lib/reap/task/package.rb +247 -105
  39. data/lib/reap/task/publish.rb +40 -14
  40. data/lib/reap/task/rdoc.rb +53 -27
  41. data/lib/reap/task/release.rb +275 -73
  42. data/lib/reap/task/scaffold.rb +14 -6
  43. data/lib/reap/task/test.rb +67 -48
  44. data/lib/reap/task/testext.rb +38 -11
  45. data/lib/reap/vendor/http-access2.rb +1590 -0
  46. data/lib/reap/vendor/http-access2/cookie.rb +538 -0
  47. data/lib/reap/vendor/http-access2/http.rb +542 -0
  48. data/{lib/reap → note}/interface/interface.rb +0 -0
  49. data/{lib/reap → note}/interface/rubyforge.rb +0 -0
  50. data/note/package.rb.0 +394 -0
  51. metadata +43 -8
  52. 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>) -&gt; String</dt>
13
+ <dt>config(<var>key</var>) -&gt; 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(&quot;prefix&quot;, &quot;/usr&quot;))
21
+ </p>
22
+ </dd>
23
+ <dt>curr_srcdir -&gt; String</dt>
24
+ <dd><p>
25
+ the current srcdir.
26
+ </p>
27
+ </dd>
28
+ <dt>curr_objdir -&gt; String</dt>
29
+ <dd><p>
30
+ the current objdir.
31
+ </p>
32
+ </dd>
33
+ <dt>srcdir_root -&gt; 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 -&gt; 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>) -&gt; 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> = '.') -&gt; [String]</dt>
71
+ <dd><p>
72
+ returns the list of file entiries in the directory
73
+ &quot;current srcdir + '/' + relpath&quot;
74
+ </p>
75
+ </dd>
76
+ <dt>srcfiles(<var>relative_path</var> = '.') -&gt; [String]</dt>
77
+ <dd><p>
78
+ returns the list of file names in the directory
79
+ &quot;current srcdir + '/' + relpath&quot;
80
+ </p>
81
+ </dd>
82
+ <dt>srcdirectories(<var>relative_path</var> = '.') -&gt; [String]</dt>
83
+ <dd><p>
84
+ returns the list of directory names in the directory
85
+ &quot;current srcdir + '/' + relpath&quot;
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(&quot;prefix&quot;)' causes fatal error.
57
+ </p>
58
+ </dd>
59
+ <dt>packages -&gt; [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 &quot;#!/usr/bin/env ruby&quot; 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 &quot;config --install-prefix&quot; to &quot;install --prefix&quot;</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 &quot;InstalledFiles&quot;</li>
113
+ <li>--with/--without accepts only package names.</li>
114
+ <li>&quot;config -- --with-foo=bar&quot; 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 &quot;make clean&quot;</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 &quot;make clean&quot; (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 &quot;make clean&quot; 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 &quot;clean&quot; (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
+ &quot;config&quot;, &quot;setup&quot; and &quot;install&quot;. 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 &quot;Task Options&quot;.
44
+ </p>
45
+ <h2>Global Options</h2>
46
+ <p>
47
+ &quot;Global Option&quot; 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 &quot;$&quot; 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 &quot;packages&quot;,
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>