setup 4.0.0

Sign up to get free protection for your applications and to get access to all the features.
Files changed (205) hide show
  1. data/COPYING +515 -0
  2. data/HISTORY +7 -0
  3. data/MANIFEST +231 -0
  4. data/METADATA +25 -0
  5. data/NEWS +21 -0
  6. data/README +110 -0
  7. data/bin/setup.rb +7 -0
  8. data/doc/manual/doc.en/devel.html +208 -0
  9. data/doc/manual/doc.en/hookapi.html +91 -0
  10. data/doc/manual/doc.en/index.html +28 -0
  11. data/doc/manual/doc.en/metaconfapi.html +79 -0
  12. data/doc/manual/doc.en/news.html +189 -0
  13. data/doc/manual/doc.en/usage.html +297 -0
  14. data/doc/manual/doc.ja/devel.html +301 -0
  15. data/doc/manual/doc.ja/hookapi.html +84 -0
  16. data/doc/manual/doc.ja/index.html +28 -0
  17. data/doc/manual/doc.ja/metaconfapi.html +80 -0
  18. data/doc/manual/doc.ja/news.html +186 -0
  19. data/doc/manual/doc.ja/usage.html +319 -0
  20. data/doc/rdoc/classes/Errno.html +89 -0
  21. data/doc/rdoc/classes/Errno/ENOTEMPTY.html +92 -0
  22. data/doc/rdoc/classes/File.html +134 -0
  23. data/doc/rdoc/classes/Setup.html +107 -0
  24. data/doc/rdoc/classes/Setup/Command.html +276 -0
  25. data/doc/rdoc/classes/Setup/ConfigTable.html +622 -0
  26. data/doc/rdoc/classes/Setup/Installer.html +2454 -0
  27. data/doc/rdoc/classes/Setup/Installer/Shebang.html +187 -0
  28. data/doc/rdoc/classes/SetupError.html +92 -0
  29. data/doc/rdoc/created.rid +1 -0
  30. data/doc/rdoc/files/COPYING.html +759 -0
  31. data/doc/rdoc/files/HISTORY.html +104 -0
  32. data/doc/rdoc/files/METADATA.html +92 -0
  33. data/doc/rdoc/files/NEWS.html +113 -0
  34. data/doc/rdoc/files/README.html +214 -0
  35. data/doc/rdoc/files/bin/setup_rb.html +96 -0
  36. data/doc/rdoc/files/lib/setup/build_rb.html +96 -0
  37. data/doc/rdoc/files/lib/setup/command_rb.html +98 -0
  38. data/doc/rdoc/files/lib/setup/config_rb.html +98 -0
  39. data/doc/rdoc/files/lib/setup/error_rb.html +92 -0
  40. data/doc/rdoc/files/lib/setup/install_rb.html +116 -0
  41. data/doc/rdoc/files/lib/setup/rake_rb.html +97 -0
  42. data/doc/rdoc/files/lib/setup/rubyver_rb.html +96 -0
  43. data/doc/rdoc/files/lib/setup_rb.html +92 -0
  44. data/doc/rdoc/fr_class_index.html +55 -0
  45. data/doc/rdoc/fr_file_index.html +60 -0
  46. data/doc/rdoc/fr_method_index.html +182 -0
  47. data/doc/rdoc/index.html +26 -0
  48. data/doc/rdoc/rdoc-style.css +177 -0
  49. data/doc/ri/Errno/ENOTEMPTY/cdesc-ENOTEMPTY.yaml +15 -0
  50. data/doc/ri/Errno/cdesc-Errno.yaml +15 -0
  51. data/doc/ri/File/cdesc-File.yaml +18 -0
  52. data/doc/ri/File/dir%3f-c.yaml +12 -0
  53. data/doc/ri/File/read-c.yaml +10 -0
  54. data/doc/ri/Setup/Command/cdesc-Command.yaml +28 -0
  55. data/doc/ri/Setup/Command/help-i.yaml +12 -0
  56. data/doc/ri/Setup/Command/run-c.yaml +11 -0
  57. data/doc/ri/Setup/Command/run-i.yaml +11 -0
  58. data/doc/ri/Setup/ConfigTable/%5b%5d%3d-i.yaml +12 -0
  59. data/doc/ri/Setup/ConfigTable/%5b%5d-i.yaml +12 -0
  60. data/doc/ri/Setup/ConfigTable/attr_accessor-c.yaml +12 -0
  61. data/doc/ri/Setup/ConfigTable/attr_boolean-c.yaml +12 -0
  62. data/doc/ri/Setup/ConfigTable/attr_pathlist-c.yaml +12 -0
  63. data/doc/ri/Setup/ConfigTable/attr_pathname-c.yaml +12 -0
  64. data/doc/ri/Setup/ConfigTable/cdesc-ConfigTable.yaml +66 -0
  65. data/doc/ri/Setup/ConfigTable/compiles%3f-i.yaml +10 -0
  66. data/doc/ri/Setup/ConfigTable/env_config-i.yaml +12 -0
  67. data/doc/ri/Setup/ConfigTable/extconfs-i.yaml +11 -0
  68. data/doc/ri/Setup/ConfigTable/extensions-i.yaml +10 -0
  69. data/doc/ri/Setup/ConfigTable/initialize_defaults-i.yaml +14 -0
  70. data/doc/ri/Setup/ConfigTable/installdirs%3d-i.yaml +12 -0
  71. data/doc/ri/Setup/ConfigTable/load_config-i.yaml +12 -0
  72. data/doc/ri/Setup/ConfigTable/new-c.yaml +12 -0
  73. data/doc/ri/Setup/ConfigTable/save_config-i.yaml +12 -0
  74. data/doc/ri/Setup/ConfigTable/shebang%3d-i.yaml +12 -0
  75. data/doc/ri/Setup/ConfigTable/show-i.yaml +10 -0
  76. data/doc/ri/Setup/Installer/Shebang/cdesc-Shebang.yaml +28 -0
  77. data/doc/ri/Setup/Installer/Shebang/load-c.yaml +10 -0
  78. data/doc/ri/Setup/Installer/Shebang/new-c.yaml +10 -0
  79. data/doc/ri/Setup/Installer/Shebang/parse-c.yaml +10 -0
  80. data/doc/ri/Setup/Installer/Shebang/to_s-i.yaml +10 -0
  81. data/doc/ri/Setup/Installer/binread-i.yaml +14 -0
  82. data/doc/ri/Setup/Installer/cdesc-Installer.yaml +281 -0
  83. data/doc/ri/Setup/Installer/clean_dir_bin-i.yaml +12 -0
  84. data/doc/ri/Setup/Installer/clean_dir_data-i.yaml +12 -0
  85. data/doc/ri/Setup/Installer/clean_dir_doc-i.yaml +12 -0
  86. data/doc/ri/Setup/Installer/clean_dir_etc-i.yaml +12 -0
  87. data/doc/ri/Setup/Installer/clean_dir_ext-i.yaml +10 -0
  88. data/doc/ri/Setup/Installer/clean_dir_lib-i.yaml +12 -0
  89. data/doc/ri/Setup/Installer/clean_dir_man-i.yaml +12 -0
  90. data/doc/ri/Setup/Installer/command-i.yaml +10 -0
  91. data/doc/ri/Setup/Installer/compiles%3f-i.yaml +10 -0
  92. data/doc/ri/Setup/Installer/config_dir_bin-i.yaml +12 -0
  93. data/doc/ri/Setup/Installer/config_dir_data-i.yaml +12 -0
  94. data/doc/ri/Setup/Installer/config_dir_doc-i.yaml +12 -0
  95. data/doc/ri/Setup/Installer/config_dir_etc-i.yaml +12 -0
  96. data/doc/ri/Setup/Installer/config_dir_ext-i.yaml +10 -0
  97. data/doc/ri/Setup/Installer/config_dir_lib-i.yaml +12 -0
  98. data/doc/ri/Setup/Installer/config_dir_man-i.yaml +12 -0
  99. data/doc/ri/Setup/Installer/curr_objdir-i.yaml +10 -0
  100. data/doc/ri/Setup/Installer/curr_srcdir-i.yaml +12 -0
  101. data/doc/ri/Setup/Installer/diff%3f-i.yaml +10 -0
  102. data/doc/ri/Setup/Installer/directories_of-i.yaml +10 -0
  103. data/doc/ri/Setup/Installer/distclean_dir_bin-i.yaml +12 -0
  104. data/doc/ri/Setup/Installer/distclean_dir_data-i.yaml +12 -0
  105. data/doc/ri/Setup/Installer/distclean_dir_doc-i.yaml +10 -0
  106. data/doc/ri/Setup/Installer/distclean_dir_etc-i.yaml +12 -0
  107. data/doc/ri/Setup/Installer/distclean_dir_ext-i.yaml +10 -0
  108. data/doc/ri/Setup/Installer/distclean_dir_lib-i.yaml +12 -0
  109. data/doc/ri/Setup/Installer/distclean_dir_man-i.yaml +12 -0
  110. data/doc/ri/Setup/Installer/dive_into-i.yaml +10 -0
  111. data/doc/ri/Setup/Installer/dllext-i.yaml +10 -0
  112. data/doc/ri/Setup/Installer/exec_all-i.yaml +12 -0
  113. data/doc/ri/Setup/Installer/exec_clean-i.yaml +12 -0
  114. data/doc/ri/Setup/Installer/exec_config-i.yaml +12 -0
  115. data/doc/ri/Setup/Installer/exec_distclean-i.yaml +12 -0
  116. data/doc/ri/Setup/Installer/exec_doc-i.yaml +11 -0
  117. data/doc/ri/Setup/Installer/exec_install-i.yaml +12 -0
  118. data/doc/ri/Setup/Installer/exec_rdoc-i.yaml +14 -0
  119. data/doc/ri/Setup/Installer/exec_ri-i.yaml +12 -0
  120. data/doc/ri/Setup/Installer/exec_setup-i.yaml +14 -0
  121. data/doc/ri/Setup/Installer/exec_show-i.yaml +12 -0
  122. data/doc/ri/Setup/Installer/exec_task_traverse-i.yaml +12 -0
  123. data/doc/ri/Setup/Installer/exec_test-i.yaml +14 -0
  124. data/doc/ri/Setup/Installer/exec_uninstall-i.yaml +12 -0
  125. data/doc/ri/Setup/Installer/existfiles-i.yaml +10 -0
  126. data/doc/ri/Setup/Installer/extconf-i.yaml +10 -0
  127. data/doc/ri/Setup/Installer/extdir%3f-i.yaml +10 -0
  128. data/doc/ri/Setup/Installer/extensions-i.yaml +12 -0
  129. data/doc/ri/Setup/Installer/files_of-i.yaml +10 -0
  130. data/doc/ri/Setup/Installer/force_remove_file-i.yaml +10 -0
  131. data/doc/ri/Setup/Installer/get_config-i.yaml +11 -0
  132. data/doc/ri/Setup/Installer/glob_reject-i.yaml +10 -0
  133. data/doc/ri/Setup/Installer/glob_select-i.yaml +10 -0
  134. data/doc/ri/Setup/Installer/globs2re-i.yaml +10 -0
  135. data/doc/ri/Setup/Installer/hookfiles-i.yaml +10 -0
  136. data/doc/ri/Setup/Installer/inspect-i.yaml +10 -0
  137. data/doc/ri/Setup/Installer/install-i.yaml +10 -0
  138. data/doc/ri/Setup/Installer/install_dir_bin-i.yaml +10 -0
  139. data/doc/ri/Setup/Installer/install_dir_data-i.yaml +10 -0
  140. data/doc/ri/Setup/Installer/install_dir_doc-i.yaml +12 -0
  141. data/doc/ri/Setup/Installer/install_dir_etc-i.yaml +10 -0
  142. data/doc/ri/Setup/Installer/install_dir_ext-i.yaml +10 -0
  143. data/doc/ri/Setup/Installer/install_dir_lib-i.yaml +10 -0
  144. data/doc/ri/Setup/Installer/install_dir_man-i.yaml +10 -0
  145. data/doc/ri/Setup/Installer/install_files-i.yaml +10 -0
  146. data/doc/ri/Setup/Installer/installation%21-i.yaml +10 -0
  147. data/doc/ri/Setup/Installer/installation%3f-i.yaml +12 -0
  148. data/doc/ri/Setup/Installer/libfiles-i.yaml +10 -0
  149. data/doc/ri/Setup/Installer/make-i.yaml +10 -0
  150. data/doc/ri/Setup/Installer/mapdir-i.yaml +10 -0
  151. data/doc/ri/Setup/Installer/mkdir_p-i.yaml +10 -0
  152. data/doc/ri/Setup/Installer/move_file-i.yaml +10 -0
  153. data/doc/ri/Setup/Installer/new-c.yaml +12 -0
  154. data/doc/ri/Setup/Installer/new_shebang-i.yaml +10 -0
  155. data/doc/ri/Setup/Installer/no_harm%3f-i.yaml +10 -0
  156. data/doc/ri/Setup/Installer/noop-i.yaml +54 -0
  157. data/doc/ri/Setup/Installer/objdir_root-i.yaml +10 -0
  158. data/doc/ri/Setup/Installer/open_atomic_writer-i.yaml +10 -0
  159. data/doc/ri/Setup/Installer/quiet%3f-i.yaml +10 -0
  160. data/doc/ri/Setup/Installer/record_installation-i.yaml +10 -0
  161. data/doc/ri/Setup/Installer/relpath-i.yaml +10 -0
  162. data/doc/ri/Setup/Installer/remove_file-i.yaml +10 -0
  163. data/doc/ri/Setup/Installer/remove_tree-i.yaml +10 -0
  164. data/doc/ri/Setup/Installer/remove_tree0-i.yaml +10 -0
  165. data/doc/ri/Setup/Installer/report_header-i.yaml +11 -0
  166. data/doc/ri/Setup/Installer/rm_f-i.yaml +10 -0
  167. data/doc/ri/Setup/Installer/rm_rf-i.yaml +10 -0
  168. data/doc/ri/Setup/Installer/rmdir-i.yaml +10 -0
  169. data/doc/ri/Setup/Installer/ruby-i.yaml +10 -0
  170. data/doc/ri/Setup/Installer/rubyextentions-i.yaml +10 -0
  171. data/doc/ri/Setup/Installer/run_hook-i.yaml +10 -0
  172. data/doc/ri/Setup/Installer/set_config-i.yaml +12 -0
  173. data/doc/ri/Setup/Installer/setup_dir_bin-i.yaml +10 -0
  174. data/doc/ri/Setup/Installer/setup_dir_data-i.yaml +12 -0
  175. data/doc/ri/Setup/Installer/setup_dir_doc-i.yaml +12 -0
  176. data/doc/ri/Setup/Installer/setup_dir_etc-i.yaml +12 -0
  177. data/doc/ri/Setup/Installer/setup_dir_ext-i.yaml +10 -0
  178. data/doc/ri/Setup/Installer/setup_dir_lib-i.yaml +12 -0
  179. data/doc/ri/Setup/Installer/setup_dir_man-i.yaml +12 -0
  180. data/doc/ri/Setup/Installer/srcdir_root-i.yaml +12 -0
  181. data/doc/ri/Setup/Installer/srcdirectories-i.yaml +10 -0
  182. data/doc/ri/Setup/Installer/srcdirectory%3f-i.yaml +10 -0
  183. data/doc/ri/Setup/Installer/srcentries-i.yaml +10 -0
  184. data/doc/ri/Setup/Installer/srcexist%3f-i.yaml +10 -0
  185. data/doc/ri/Setup/Installer/srcfile%3f-i.yaml +10 -0
  186. data/doc/ri/Setup/Installer/srcfile-i.yaml +10 -0
  187. data/doc/ri/Setup/Installer/srcfiles-i.yaml +10 -0
  188. data/doc/ri/Setup/Installer/targetfiles-i.yaml +10 -0
  189. data/doc/ri/Setup/Installer/traverse-i.yaml +10 -0
  190. data/doc/ri/Setup/Installer/update_shebang_line-i.yaml +10 -0
  191. data/doc/ri/Setup/Installer/verbose%3f-i.yaml +10 -0
  192. data/doc/ri/Setup/Installer/verbose_off-i.yaml +10 -0
  193. data/doc/ri/Setup/cdesc-Setup.yaml +15 -0
  194. data/doc/ri/SetupError/cdesc-SetupError.yaml +15 -0
  195. data/doc/ri/created.rid +1 -0
  196. data/lib/setup.rb +5 -0
  197. data/lib/setup/build.rb +2 -0
  198. data/lib/setup/command.rb +169 -0
  199. data/lib/setup/config.rb +339 -0
  200. data/lib/setup/error.rb +1 -0
  201. data/lib/setup/install.rb +915 -0
  202. data/lib/setup/rake.rb +62 -0
  203. data/lib/setup/rubyver.rb +25 -0
  204. data/script/install +6 -0
  205. metadata +293 -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>