source: general/prog/ruby.xml@ 8d68192

10.0 10.1 11.0 11.1 11.2 11.3 12.0 12.1 12.2 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind gimp3 kea ken/TL2024 ken/inkscape-core-mods ken/tuningfonts lazarus lxqt nosym perl-modules plabs/newcss plabs/python-mods python3.11 qt5new rahul/power-profiles-daemon renodr/vulkan-addition trunk upgradedb xry111/for-12.3 xry111/intltool xry111/llvm18 xry111/soup3 xry111/spidermonkey128 xry111/test-20220226 xry111/xf86-video-removal
Last change on this file since 8d68192 was 8d68192, checked in by Bruce Dubbs <bdubbs@…>, 8 years ago

Update to ntp-4.2.8p9.
Update to ruby-2.3.3.

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