source: general/prog/ruby.xml@ 6030130

10.0 10.1 11.0 9.0 9.1 ken/refactor-virt lazarus qt5new trunk xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since 6030130 was 6030130, checked in by Douglas R. Reno <renodr@…>, 2 years ago

Update to git-2.23.0
Tag the rest of the packages I normally build before Xorg

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@21991 af4574ff-66df-0310-9fd7-8a98e5e911e0

  • Property mode set to 100644
File size: 8.0 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
6
7 <!ENTITY ruby-download-http "http://cache.ruby-lang.org/pub/ruby/&ruby-minor-version;/ruby-&ruby-version;.tar.xz">
8 <!ENTITY ruby-download-ftp " ">
9 <!ENTITY ruby-md5sum "60c8b3883cde410f8f8db374febdb0d8">
10 <!ENTITY ruby-size "11 MB">
11 <!ENTITY ruby-buildsize "414 MB (add 277 MB for C API docs)">
12 <!ENTITY ruby-time "1.2 SBU (using parallelism=4; add 3.6 SBU for tests; add 0.6 SBU for C API docs)">
13]>
14
15<sect1 id="ruby" xreflabel="Ruby-&ruby-version;">
16 <?dbhtml filename="ruby.html"?>
17
18 <sect1info>
19 <othername>$LastChangedBy$</othername>
20 <date>$Date$</date>
21 </sect1info>
22
23 <title>Ruby-&ruby-version;</title>
24
25 <indexterm zone="ruby">
26 <primary sortas="a-Ruby">Ruby</primary>
27 </indexterm>
28
29 <sect2 role="package">
30 <title>Introduction to Ruby</title>
31
32 <para>
33 The <application>Ruby</application> package contains the
34 <application>Ruby</application> development environment. This
35 is useful for object-oriented scripting.
36 </para>
37
38 &lfs90_checked;
39
40 <bridgehead renderas="sect3">Package Information</bridgehead>
41 <itemizedlist spacing="compact">
42 <listitem>
43 <para>
44 Download (HTTP): <ulink url="&ruby-download-http;"/>
45 </para>
46 </listitem>
47 <listitem>
48 <para>
49 Download (FTP): <ulink url="&ruby-download-ftp;"/>
50 </para>
51 </listitem>
52 <listitem>
53 <para>
54 Download MD5 sum: &ruby-md5sum;
55 </para>
56 </listitem>
57 <listitem>
58 <para>
59 Download size: &ruby-size;
60 </para>
61 </listitem>
62 <listitem>
63 <para>
64 Estimated disk space required: &ruby-buildsize;
65 </para>
66 </listitem>
67 <listitem>
68 <para>
69 Estimated build time: &ruby-time;
70 </para>
71 </listitem>
72 </itemizedlist>
73
74 <bridgehead renderas="sect3">Ruby Dependencies</bridgehead>
75
76 <bridgehead renderas="sect4">Optional</bridgehead>
77 <para role="optional">
78 <xref linkend="db"/>,
79 <xref linkend="doxygen"/>,
80 <xref linkend="graphviz"/>,
81 <xref linkend="libyaml"/>,
82 <xref linkend="tk"/>, and
83 <xref linkend="valgrind"/>
84 </para>
85
86 <para condition="html" role="usernotes">User Notes:
87 <ulink url="&blfs-wiki;/ruby"/>
88 </para>
89 </sect2>
90
91 <sect2 role="installation">
92 <title>Installation of Ruby</title>
93
94 <para>
95 Install <application>Ruby</application> by running the following
96 command:
97 </para>
98
99<screen><userinput>./configure --prefix=/usr \
100 --enable-shared \
101 --docdir=/usr/share/doc/ruby-&ruby-version; &amp;&amp;
102make</userinput></screen>
103
104 <para>
105 Optionally, build the CAPI documents by running the following
106 commands:
107 </para>
108
109<screen><userinput>make capi</userinput></screen>
110
111 <para>
112 To test the results, issue: <command>make check</command>. There are
113 over 20,000 tests. Some tests (up to 0.5 percent) may fail.
114 If the tests are run in a directory
115 that has a world writable component (e.g. /tmp) then several additional
116 tests may fail. Several jit (just-in-time) tests are known to fail.
117 </para>
118
119 <para>
120 Now, as the <systemitem class="username">root</systemitem> user:
121 </para>
122
123<screen role="root"><userinput>make install</userinput></screen>
124
125 </sect2>
126
127 <sect2 role="commands">
128 <title>Command Explanations</title>
129
130 <para>
131 <parameter>--enable-shared</parameter>: This switch enables building of
132 the <filename class="libraryfile">libruby</filename> shared library.
133 </para>
134
135 <para>
136 <option>--disable-install-doc</option>: This switch disables building and
137 installing rdoc indexes and C API documents.
138 </para>
139
140 <para>
141 <option>--disable-install-rdoc</option>: This switch disables building
142 and installing rdoc indexes.
143 </para>
144
145 <para>
146 <option>--disable-install-capi</option>: This switch disables building
147 and installing C API documents.
148 </para>
149
150 </sect2>
151
152 <sect2 role="content">
153 <title>Contents</title>
154
155 <segmentedlist>
156 <segtitle>Installed Programs</segtitle>
157 <segtitle>Installed Libraries</segtitle>
158 <segtitle>Installed Directories</segtitle>
159
160 <seglistitem>
161 <seg>
162 erb, gem, irb, rake, rdoc, ri, and ruby
163 </seg>
164 <seg>
165 libruby.so and libruby-static.a
166 </seg>
167 <seg>
168 /usr/include/ruby-&ruby-minor-version;.0
169 /usr/lib/ruby,
170 /usr/share/doc/ruby-&ruby-version; and
171 /usr/share/ri
172 </seg>
173 </seglistitem>
174 </segmentedlist>
175
176 <variablelist>
177 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
178 <?dbfo list-presentation="list"?>
179 <?dbhtml list-presentation="table"?>
180
181 <varlistentry id="erb">
182 <term><command>erb</command></term>
183 <listitem>
184 <para>
185 is Tiny eRuby. It interprets a
186 <application>Ruby</application> code embedded text file.
187 </para>
188 <indexterm zone="ruby erb">
189 <primary sortas="b-erb">erb</primary>
190 </indexterm>
191 </listitem>
192 </varlistentry>
193
194 <varlistentry id="gem">
195 <term><command>gem</command></term>
196 <listitem>
197 <para>
198 command for RubyGems - a sophisticated package manager for
199 <application>Ruby</application>.
200 </para>
201 <indexterm zone="ruby gem">
202 <primary sortas="b-gem">gem</primary>
203 </indexterm>
204 </listitem>
205 </varlistentry>
206
207 <varlistentry id="irb">
208 <term><command>irb</command></term>
209 <listitem>
210 <para>
211 is the interactive interface for
212 <application>Ruby</application>.
213 </para>
214 <indexterm zone="ruby irb">
215 <primary sortas="b-irb">irb</primary>
216 </indexterm>
217 </listitem>
218 </varlistentry>
219
220 <varlistentry id="rake">
221 <term><command>rake</command></term>
222 <listitem>
223 <para>
224 a make-like build utility for <application>Ruby</application>.
225 </para>
226 <indexterm zone="ruby rake">
227 <primary sortas="b-rake">rake</primary>
228 </indexterm>
229 </listitem>
230 </varlistentry>
231
232 <varlistentry id="rdoc">
233 <term><command>rdoc</command></term>
234 <listitem>
235 <para>
236 generates <application>Ruby</application> documentation.
237 </para>
238 <indexterm zone="ruby rdoc">
239 <primary sortas="b-rdoc">rdoc</primary>
240 </indexterm>
241 </listitem>
242 </varlistentry>
243
244 <varlistentry id="ri">
245 <term><command>ri</command></term>
246 <listitem>
247 <para>
248 displays documentation from a database on
249 <application>Ruby</application> classes, modules, and methods.
250 </para>
251 <indexterm zone="ruby ri">
252 <primary sortas="b-ri">ri</primary>
253 </indexterm>
254 </listitem>
255 </varlistentry>
256
257 <varlistentry id="ruby-prog">
258 <term><command>ruby</command></term>
259 <listitem>
260 <para>
261 is an interpreted scripting language for quick
262 and easy object-oriented programming.
263 </para>
264 <indexterm zone="ruby ruby-prog">
265 <primary sortas="b-ruby">ruby</primary>
266 </indexterm>
267 </listitem>
268 </varlistentry>
269
270 <varlistentry id="libruby">
271 <term><filename role="libraryfile">libruby.so</filename></term>
272 <listitem>
273 <para>
274 contains the API functions required by <application>Ruby</application>.
275 </para>
276 <indexterm zone="ruby libruby">
277 <primary sortas="c-libruby">libruby.so</primary>
278 </indexterm>
279 </listitem>
280 </varlistentry>
281
282 </variablelist>
283
284 </sect2>
285
286</sect1>
Note: See TracBrowser for help on using the repository browser.