source: archive/js38.xml

trunk
Last change on this file was 45ab6c7, checked in by Xi Ruoyao <xry111@…>, 3 months ago

more SVN prop clean up

Remove "$LastChanged$" everywhere, and also some unused $Date$

  • Property mode set to 100644
File size: 6.9 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 js38-download-http "&sources-anduin-http;/mozjs/mozjs-&JS38-version;.rc0.tar.bz2">
8 <!ENTITY js38-download-ftp " ">
9 <!ENTITY js38-md5sum "cb602e21f5fc798b88163a3aa4e03e0a">
10 <!ENTITY js38-size "24 MB">
11 <!ENTITY js38-buildsize "896 MB">
12 <!ENTITY js38-time "3.3 SBU">
13]>
14
15<sect1 id="js38" xreflabel="js38-&JS38-version;">
16 <?dbhtml filename="js38.html"?>
17
18 <sect1info>
19 <date>$Date$</date>
20 </sect1info>
21
22 <title>JS-&JS38-version;</title>
23
24 <indexterm zone="js38">
25 <primary sortas="a-js38">js38</primary>
26 </indexterm>
27
28 <sect2 role="package">
29 <title>Introduction to JS</title>
30
31 <para>
32 <application>JS</application> is Mozilla's JavaScript engine
33 written in C.
34 </para>
35
36 &lfs82_checked;
37
38 <bridgehead renderas="sect3">Package Information</bridgehead>
39 <itemizedlist spacing="compact">
40 <listitem>
41 <para>
42 Download (HTTP): <ulink url="&js38-download-http;"/>
43 </para>
44 </listitem>
45 <listitem>
46 <para>
47 Download (FTP): <ulink url="&js38-download-ftp;"/>
48 </para>
49 </listitem>
50 <listitem>
51 <para>
52 Download MD5 sum: &js38-md5sum;
53 </para>
54 </listitem>
55 <listitem>
56 <para>
57 Download size: &js38-size;
58 </para>
59 </listitem>
60 <listitem>
61 <para>
62 Estimated disk space required: &js38-buildsize;
63 </para>
64 </listitem>
65 <listitem>
66 <para>
67 Estimated build time: &js38-time;
68 </para>
69 </listitem>
70 </itemizedlist>
71
72 <bridgehead renderas="sect3">Additional Downloads</bridgehead>
73 <itemizedlist spacing="compact">
74 <listitem>
75 <para>
76 Required patch:
77 <ulink url="&patch-root;/js38-&JS38-version;-upstream_fixes-2.patch"/>
78 </para>
79 </listitem>
80 </itemizedlist>
81
82 <bridgehead renderas="sect3">JS38 Dependencies</bridgehead>
83
84 <bridgehead renderas="sect4">Required</bridgehead>
85 <para role="required">
86 <xref linkend="autoconf213"/>,
87 <xref linkend="icu"/>,
88 <xref linkend="nspr"/>,
89 <xref linkend="python2"/>, and
90 <xref linkend="zip"/>
91 </para>
92
93 <bridgehead renderas="sect4">Optional</bridgehead>
94 <para role="optional">
95 <xref linkend="doxygen"/>
96 </para>
97
98 <para condition="html" role="usernotes">
99 User Notes: <ulink url="&blfs-wiki;/js38"/>
100 </para>
101 </sect2>
102
103 <sect2 role="installation">
104 <title>Installation of JS</title>
105
106 <warning>
107 <para>The tarball extracts to mozjs-38.0.0, rather than what is
108 listed in the download section.</para>
109 </warning>
110
111 <para>
112 First, apply a patch to fix the build and to prevent segmentation
113 faults.
114 </para>
115
116<screen><userinput remap="pre">patch -Np1 -i ../js38-&JS38-version;-upstream_fixes-2.patch</userinput></screen>
117
118 <para>
119 Install <application>JS</application> by running the following
120 commands:
121 </para>
122
123<!-- Spaces are significant in <screen> sections -->
124<screen><userinput>cd js/src &amp;&amp;
125autoconf2.13 &amp;&amp;
126
127./configure --prefix=/usr \
128 --with-intl-api \
129 --with-system-zlib \
130 --with-system-ffi \
131 --with-system-nspr \
132 --with-system-icu \
133 --enable-threadsafe \
134 --enable-readline &amp;&amp;
135make</userinput></screen>
136
137 <para>
138 This package does not come with a working test suite.
139 </para>
140
141 <para>
142 Now, as the <systemitem class="username">root</systemitem> user:
143 </para>
144
145<screen role="root"><userinput>make install &amp;&amp;
146pushd /usr/include/mozjs-38 &amp;&amp;
147for link in `find . -type l`; do
148 header=`readlink $link`
149 rm -f $link
150 cp -pv $header $link
151 chmod 644 $link
152done &amp;&amp;
153popd &amp;&amp;
154
155chown -Rv root.root /usr/include/mozjs-38</userinput></screen>
156
157 </sect2>
158
159 <!--Optional section-->
160 <sect2 role="commands">
161 <title>Command Explanations</title>
162
163 <para>
164 <command>autoconf2.13</command>: This command regenerates the configure
165 script with the changes from the patch.
166 </para>
167
168 <para>
169 <parameter>--with-*</parameter>: These parameters allow the build system
170 to use system versions of the above libraries. These are required for
171 stability.
172 </para>
173
174 <para>
175 <parameter>--enable-readline</parameter>: This switch enables Readline
176 support in the JS shell.
177 </para>
178
179 <para>
180 <parameter>--enable-threadsafe</parameter>: This switch enables support
181 for multiple threads at one time. This increases performance as well as
182 stability.
183 </para>
184
185 <para>
186 <command>for link in</command>...: This command replaces links to the
187 build directory, with files copied from the build directory.
188 </para>
189 </sect2>
190
191 <sect2 role="content">
192 <title>Contents</title>
193
194 <segmentedlist>
195 <segtitle>Installed Programs</segtitle>
196 <segtitle>Installed Libraries)</segtitle>
197 <segtitle>Installed Directories</segtitle>
198
199 <seglistitem>
200 <seg>
201 js38 and js38-config
202 </seg>
203 <!-- Yes, the static library is required. -->
204 <seg>
205 libmozjs-38.so and libjs_static.ajs
206 </seg>
207 <seg>
208 /usr/include/mozjs-38
209 </seg>
210 </seglistitem>
211 </segmentedlist>
212
213 <variablelist>
214 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
215 <?dbfo list-presentation="list"?>
216 <?dbhtml list-presentation="table"?>
217
218 <varlistentry id="js3-js38">
219 <term><command>js38</command></term>
220 <listitem>
221 <para>
222 provides a command line interface to the
223 <application>JavaScript</application> engine.
224 </para>
225 <indexterm zone="js38 js38">
226 <primary sortas="b-js38">js38</primary>
227 </indexterm>
228 </listitem>
229 </varlistentry>
230
231 <varlistentry id="js38-config">
232 <term><command>js38-config</command></term>
233 <listitem>
234 <para>
235 is used to find the JS compiler and linker flags.
236 </para>
237 <indexterm zone="js38 js38-config">
238 <primary sortas="b-js38-config">js38-config</primary>
239 </indexterm>
240 </listitem>
241 </varlistentry>
242
243 <varlistentry id="libmozjs-38">
244 <term><filename class="libraryfile">libmozjs-38.so</filename></term>
245 <listitem>
246 <para>
247 contains the Mozilla JavaScript API functions.
248 </para>
249 <indexterm zone="js38 libmozjs-38">
250 <primary sortas="c-libmozjs38">libmozjs-38.so</primary>
251 </indexterm>
252 </listitem>
253 </varlistentry>
254 </variablelist>
255 </sect2>
256</sect1>
Note: See TracBrowser for help on using the repository browser.