source: general/genlib/js78.xml@ 27a7cc5

10.1 11.0 ken/refactor-virt lazarus qt5new trunk xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since 27a7cc5 was 27a7cc5, checked in by Ken Moffat <ken@…>, 10 months ago

Firefox-78.6.0 and JS78.6.0.

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

  • Property mode set to 100644
File size: 10.2 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 ff78-version "&firefox-version;">
8 <!ENTITY js78-download-http "&mozilla-http;/firefox/releases/&ff78-version;esr/source/firefox-&ff78-version;esr.source.tar.xz">
9 <!ENTITY js78-download-ftp " ">
10 <!ENTITY js78-md5sum "2df7dcedba6229f243dcf327ad3e7306">
11 <!ENTITY js78-size "323 MB">
12 <!ENTITY js78-buildsize "3.0 GB (36 MB installed after removing 35MB static lib)">
13 <!ENTITY js78-time "2.5 SBU (with parallelism = 4)">
14]>
15
16<sect1 id="js78" xreflabel="js78-&ff78-version;">
17 <?dbhtml filename="js78.html"?>
18
19 <sect1info>
20 <othername>$LastChangedBy$</othername>
21 <date>$Date$</date>
22 </sect1info>
23
24 <title>JS-&ff78-version;</title>
25
26 <indexterm zone="js78">
27 <primary sortas="a-js78">js78</primary>
28 </indexterm>
29
30 <sect2 role="package">
31 <title>Introduction to JS</title>
32
33 <para>
34 <application>JS</application> is Mozilla's JavaScript engine
35 written in C. JS78 is taken from Firefox.
36 </para>
37
38 <bridgehead renderas="sect3">Package Information</bridgehead>
39 <itemizedlist spacing="compact">
40 <listitem>
41 <para>
42 Download (HTTP): <ulink url="&js78-download-http;"/>
43 </para>
44 </listitem>
45 <listitem>
46 <para>
47 Download (FTP): <ulink url="&js78-download-ftp;"/>
48 </para>
49 </listitem>
50 <listitem>
51 <para>
52 Download MD5 sum: &js78-md5sum;
53 </para>
54 </listitem>
55 <listitem>
56 <para>
57 Download size: &js78-size;
58 </para>
59 </listitem>
60 <listitem>
61 <para>
62 Estimated disk space required: &js78-buildsize;
63 </para>
64 </listitem>
65 <listitem>
66 <para>
67 Estimated build time: &js78-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;/js78-code_coverage-1.patch"/>
78 </para>
79 </listitem>
80 </itemizedlist>
81-->
82 <bridgehead renderas="sect3">JS78 Dependencies</bridgehead>
83
84 <bridgehead renderas="sect4">Required</bridgehead>
85 <para role="required">
86 <xref linkend="autoconf213"/>,
87 <xref linkend="icu"/>,
88 <xref linkend="rust"/>, and
89 <xref linkend="which"/>
90 <!-- Should we list llvm here? -->
91 </para>
92
93 <!-- It seems nasm is only used for aarch64-win64. -->
94 <!--bridgehead renderas="sect4">Optional</bridgehead>
95 <para role="optional">
96 <xref linkend="nasm"/>
97 </para-->
98
99 <para condition="html" role="usernotes">
100 User Notes: <ulink url="&blfs-wiki;/js78"/>
101 </para>
102 </sect2>
103
104 <sect2 role="installation">
105 <title>Installation of JS</title>
106
107 <caution>
108 <para>
109 If you are upgrading JS78 from a previously installed old version,
110 save all work and exit your GNOME Session if you have one running.
111 Replacing the JS78 binary will cause the GNOME Shell to crash and
112 return you to your display manager or TTY. After installing the new
113 version, if GNOME Shell still doesn't work, reinstall
114 <xref linkend="gjs"/>.
115 </para>
116 </caution>
117
118 <note>
119 <para>
120 Unlike most other packages in BLFS, the instructions below require you
121 to untar <filename>firefox-&ff78-version;esr.tar.xz</filename> and
122 change into the <filename>firefox-&ff78-version;</filename> folder.
123 </para>
124
125 <para>
126 Extracting the tarball
127 will reset the permissions of the current directory to 0755 if you
128 have permission to do that. If you do this in a directory where
129 the sticky bit is set, such
130 as <filename class="directory">/tmp</filename> it will end with error
131 messages:
132 </para>
133
134<literallayout>tar: .: Cannot utime: Operation not permitted
135tar: .: Cannot change mode to rwxr-xr-t: Operation not permitted
136tar: Exiting with failure status due to previous errors
137</literallayout>
138
139 <para>
140 This does finish with non-zero status, but it does
141 <emphasis>NOT</emphasis> mean there is a real problem.
142 Do not untar as the <systemitem class="username">root</systemitem> user
143 in a directory where the sticky bit is set - that will unset it.
144 </para>
145
146 </note>
147
148<!-- It's merged in 78.2.0.
149 <para>
150 Apply a patch required by <xref linkend="gjs"/>:
151 </para>
152
153<screen><userinput>patch -Np1 -i ../js78-code_coverage-1.patch</userinput></screen>
154-->
155 <para>
156 Install <application>JS</application> by running the following
157 commands:
158 </para>
159
160 <note>
161 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
162 href="../../xincludes/mozshm.xml"/>
163
164 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
165 href="../../xincludes/mozconfigure.xml"/>
166 </note>
167
168
169<screen><userinput>mkdir obj &amp;&amp;
170cd obj &amp;&amp;
171
172CC=gcc CXX=g++ \
173../js/src/configure --prefix=/usr \
174 --with-intl-api \
175 --with-system-zlib \
176 --with-system-icu \
177 --disable-jemalloc \
178 --disable-debug-symbols \
179 --enable-readline &amp;&amp;
180make</userinput></screen>
181
182 <para>
183 To run JS test suite, issue:
184 <command>make -C js/src check-jstests
185 JSTESTS_EXTRA_ARGS="--timeout 300 --wpt=disabled"</command>.
186 It's recommended to redirect the output into a log.
187 <!-- recheck when ICU gets upgraded -->
188 <!-- ken: removed "are known to fail' becasue there are
189 4096 known failures, these icu items are unexpected failures
190 and I found the wording confusing -->
191 <!-- ken : For 78.4 this was 14 failures, I changed it to 10 for 78.5.
192 On that machine with 78.6 still 10, but on another 14, both with similar
193 setup and locale. -->
194 Depending on the machine, either
195 ten or fourteen JS tests related to locale and timezone fail,
196 because of an issue in <xref linkend="icu"/>.
197 To run the JIT test suite, issue:
198 <command>make -C js/src check-jit-test
199 JITTEST_EXTRA_ARGS="--timeout 300"</command>. Again, a few tests
200 may show as unexpected failures.
201 </para>
202
203 <para>
204 Now, as the <systemitem class="username">root</systemitem> user:
205 </para>
206
207<screen role="root"><userinput>make install &amp;&amp;
208rm -v /usr/lib/libjs_static.ajs &amp;&amp;
209sed -i '/@NSPR_CFLAGS@/d' /usr/bin/js78-config</userinput></screen>
210
211 </sect2>
212
213 <!-- Several gjs-1.65.90 tests fail with js78. Not sure why.
214 OTOH an "otherwise" GNOME-3.36 environment works fine. -->
215
216 <sect2 role="commands">
217 <title>Command Explanations</title>
218
219 <para>
220 <envar>CC=gcc CXX=g++</envar>: Upstream now prefers
221 <application>clang</application>, override it like other Mozilla
222 packages in BLFS book.
223 </para>
224
225 <para>
226 <parameter>--with-*</parameter>: These parameters allow the build system
227 to use system versions of the above libraries. These are required for
228 stability.
229 </para>
230
231 <para>
232 <parameter>--enable-readline</parameter>: This switch enables Readline
233 support in the JS shell.
234 </para>
235
236 <para>
237 <parameter>--disable-jemalloc</parameter>: This switch disables the
238 internal memory allocator used in JS78. jemalloc is only intended for
239 the Firefox browser environment. For other applications using JS78,
240 if JS78 uses jemalloc, the application may crash as items allocated
241 in jemalloc allocator are freed on system (glibc) allocator.
242 </para>
243
244 <para>
245 <parameter>--disable-debug-symbols</parameter>: Don't generate debug
246 symbols since they are very large and most users won't need it. Remove
247 it if you want to debug JS78.
248 </para>
249
250 <para>
251 <command>rm -v /usr/lib/libjs_static.ajs</command>: Remove a large
252 static library which is not used by any BLFS package.
253 </para>
254
255 <para>
256 <command>sed -i '/@NSPR_CFLAGS@/d' /usr/bin/js78-config</command>:
257 Prevent <command>js78-config</command> from using buggy CFLAGS.
258 </para>
259
260 </sect2>
261
262 <sect2 role="content">
263 <title>Contents</title>
264
265 <segmentedlist>
266 <segtitle>Installed Programs</segtitle>
267 <segtitle>Installed Libraries</segtitle>
268 <segtitle>Installed Directories</segtitle>
269
270 <seglistitem>
271 <seg>
272 js78 and js78-config
273 </seg>
274 <seg>
275 libmozjs-78.so
276 </seg>
277 <seg>
278 /usr/include/mozjs-78
279 </seg>
280 </seglistitem>
281 </segmentedlist>
282
283 <variablelist>
284 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
285 <?dbfo list-presentation="list"?>
286 <?dbhtml list-presentation="table"?>
287
288 <varlistentry id="js6-js78">
289 <term><command>js78</command></term>
290 <listitem>
291 <para>
292 provides a command line interface to the
293 <application>JavaScript</application> engine.
294 </para>
295 <indexterm zone="js78 js78">
296 <primary sortas="b-js78">js78</primary>
297 </indexterm>
298 </listitem>
299 </varlistentry>
300
301 <varlistentry id="js78-config">
302 <term><command>js78-config</command></term>
303 <listitem>
304 <para>
305 is used to find the JS compiler and linker flags.
306 </para>
307 <indexterm zone="js78 js78-config">
308 <primary sortas="b-js78-config">js78-config</primary>
309 </indexterm>
310 </listitem>
311 </varlistentry>
312
313 <varlistentry id="libmozjs-78">
314 <term><filename class="libraryfile">libmozjs-78.so</filename></term>
315 <listitem>
316 <para>
317 contains the Mozilla JavaScript API functions.
318 </para>
319 <indexterm zone="js78 libmozjs-78">
320 <primary sortas="c-libmozjs78">libmozjs-78.so</primary>
321 </indexterm>
322 </listitem>
323 </varlistentry>
324 </variablelist>
325 </sect2>
326</sect1>
Note: See TracBrowser for help on using the repository browser.